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1 What is acomputer? 


A computer is a general purpose electronic machine that can be 
instructed to do a great variety of things — play games, perform complex 
calculations, store and retrieve information, display graphs and so on. 


You can ask a computer to do things directly — by typing commands onits 
keyboard — but for complex tasks, a whole series of instructions is usually 
written and stored in the computer's memory. The computer can be 
instructed to call up these instructions one by one and carry them out, 
very fast. (Your Electron can carry out, or ‘execute’, over 254,000 
separate instructions every second.) 


A series of instructions like this is called a program. Programs can be 
recorded onto cassette by using a suitable cassette recorder in much the 
same way as you might record a piece of music. The main difference is 
that the recording is made from a computer, and is played back into the 
computer again. You can buy pre-recorded programs which have been 
written by other people, and to start you off, several programs are 
provided on the Introductory Cassette which comes with your Electron, 


The first part of this book describes how to set up your computer, and 
load and run the programs on the Introductory Cassette. For information 
on other programs available for the Electron (the general name for 
programs is ‘software’), write to: 


Acornsoft Limited 
4a Market Hill 
Cambridge CB2 3NJ 


The remainder of this book (chapter 4 onwards), and the book Start 
Programming with the Electron, will tell you how to write your own 
programs on your Electron computer. You do not need to know this in 
order to use your computer, as there are many commercially available 
programs — but we hope that you will be interested and will want to find 
out more about your Electron. 


2, Getting started 


Welcome to the Acorn Electron Microcomputer! 


Chapters 2 and 3 explain how to connect your Electron to the mains and 
to a television or monitor. Please read them carefully before continuing. 


Checklist of items 


Apart from this User Guide, you should have the following items in the 
box you’ve just opened: 


— An Electron Microcomputer 

— A mains adapter 

- Guarantee registration card 

An aerial lead about two metres long for connecting the computer to 
your television set 

— The Introductory Cassette 

A book called Start Programming with the Electron 
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If any of these items are missing, please contact your supplier. 


Additional items 
You will also need the following: 


~ A television set, or a good quality monochrome or colour monitor 
— Amono (or stereo) cassette recorder, preferably with these facilities: 


An external motor control facility 
Record/playback socket(s) where the playback volume is controlled 
by the volume control 


If you are going to buy a cassette recorder specifically to use with your 
Electron, your supplier will be able to recommend a suitable machine. 
However, most domestic machines can be used with good results, and 
chapter 3 gives details on how to connect a cassette machine to the 
Electron. 


Connecting the Electron to your television set 


Please refer to the diagram. 
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Aerial lead 


To Electron <% 


4 Getting started 


If you are using a monitor rather than a television, then ignore this 
section, and read the section opposite, ‘Connecting the Electron to a 
monitor’; otherwise read on. 


You need to use the long TV lead provided to connect the Electron to 
your television set, and one end of this should be plugged into the aerial 
socket on the back of your television set, having first removed any aerial 
lead already connected. If your television uses its own aerial mounted on 
the set, you will need to find the aerial socket marked AERIAL, or ANT, 
or UHF etc. 


The other end of the lead should be plugged into the socket marked 
‘UHF TV’ on the left hand side of the Electron case. If you look at the 
case, you will see four sockets side by side. If you then look at the bottom 
of the case underneath the sockets, you will see that the name of each 
socket is engraved there. (The ‘UHF TV’ socket is the one on the extreme 
left.) 


Now switch on the television. 


Connecting the Electron to the mains 


The mains adapter which comes with the Electron has one lead which 
should be plugged into the socket on the right hand side of the Electron 
case. This socket is engraved ‘19V AC POWER IN’. The mains adapter 
itself can be plugged into a domestic 13A socket. 


Having connected the mains adapter to the Electron and to the mains, 
the computer is now ON. As soon as the Electron switches on, you will 
hear a ‘bleep’, and the yellow light on the left hand side of the keyboard 
comes on. If this does not happen, first check that your 13A socket is 
working and is switched on (if it has a switch), and, if it still does not work, 
contact your local dealer. 


Tuning the TV to the Electron 


The Electron should now be connected to the mains adapter and 
switched on, and the TV lead should be connected to your television and 
to the Electron. The next thing to do is to tune your television. 


First of all, turn the TV volume control to minimum — the Electron 
provides its own sound. 
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Most TVs have either a number of push-buttons or a single tuning knob 
for selecting TV stations. 


Push-button tuning 

Choose and select a push-button you don’t normally use, and turn its 
tuning knob as far as you can in one direction, then turn it slowly the other 
way until the following message (or something very similar) appears on 
your television screen: 


Acorn Electron @ 


BASIC 


> 


Single tuning knob 

Turn the tuning knob as far as you can in one direction, then turn it slowly 
in the other direction until something like the message above appears on 
your television screen. 


Connecting the Electron to a monitor 


This section only applies if you are using a monitor rather than a TV. 


Monochrome monitor 

You will need to acquire a special lead which should be available from the 
supplier of the monitor. The end of the lead which plugs into the Electron 
should be inserted into the socket marked ‘VIDEO’ on the left hand side 
of the Electron case. If you look at the bottom of the case, you will see 
that the name of each socket is engraved there. 


Colour (RGB) monitor 

A special lead should be supplied with the RGB monitor to plug into the 
Electron. The end of the lead which plugs into the Electron should be 
inserted into the socket marked ‘RGB’ on the left hand side of the 
Electron case. If you look at the bottom of the case, you will see that the 
name of the socket is engraved there. 


Now try something 


Take a look at the TV screen. If you have already pressed any keys on the 
Electron’s keyboard you will probably see something unintelligible 
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displayed on the screen. To remove this, press the key on the keyboard 
marked ELE. Then press any keys you like on the keyboard —as many 
as you like — you cannot damage the computer whatever you press! The 
little flashing line on the screen is called the CURSOR and is to show you 
where the next character you type will appear. 


Tf you press the GIAMGL key at any stage, a new line is started and the 
computer will probably display a message on the screen immediately 
underneath what you’ve typed, such as 


Mistake 
or 
Syntax error 


or something else. Don’t take any notice of this; the Electron’s command 
of the English language isn’t quite as good as yours! Later on we will show 


you how to tell the Electron to do things for you by using its own language 
called BASIC. 


If you press a key and hold your finger on it, you will notice that after a 
short time the character displayed on the screen repeats itself over and 
over until you take your finger off the key again. 


If the yellow light to the left of the PEUETUg key is still on, then letters of 
the alphabet will appear on the screen as capital (‘upper case’) letters. 


To type small letters, press the LAM key and hold it down while you 


press the PEGA key. The yellow light goes out, and you can now type 
‘lower case’ letters on the screen. 


To get back to capitals, press Ea and PAGAIY again— the keyboard 
is now locked into producing ‘upper case’ letters again. 


Spend some time playing with the keyboard if you aren’t very familiar 
with the layout, and if anything strange happens, just press the 
key. This will clear the screen and you can continue. When you get to 
chapter 5 the keyboard operation is explained in detail. 


The different typefaces used in this book represent the following: 


- Ordinary text appears like this, or like this for emphasis. 
— Text typed into the computer or displayed on the screen appears 
like this or like this. 
— Words like mean that you press the key marked RETURN 
rather than actually type the letters RE TURN. 


3 Using a cassette 
recorder 


Introduction 


When you have learnt to write programs that enable the Electron to do 
things for you, it will soon become obvious that you need to make a copy 
of these programs for future use. One very good reason being that when 
you switch off the Electron, everything you typed into the computer is 
forgotten. The Electron gives you the facility of recording your programs 
onto cassettes for future use (just as you might record music). 


Not only this, but you can then play back pre-recorded programs for the 
Electron which other people have written, and make them work on the 
Electron. 


This chapter tells you how to set up your cassette recorder for saving or 
loading programs. These programs will show you some of the things the 
Electron Microcomputer can do. 


First of all, you need to connect a suitable cassette recorder to the 
Electron. 


Connecting a cassette recorder 


The sort of lead you need to connect the Electron to a cassette recorder 
depends on what type of sockets are fitted to your cassette recorder. One 
end of the lead must have a 5-pin or 7-pin DIN plug fitted, and this plugs 
into the socket on the left hand side of the Electron case marked 
‘CASSETTE’ - you will find the name engraved on the bottom of the 
case immediately below the socket. 


The wiring diagram overleaf shows the wiring of the CASSETTE socket on 
the Electron as you look at it from the mating side. 


Your nearest Electron dealer or hi-fi dealer should be able to help 
provide the correct lead if you have any problems, especially if you show 
him the drawing. 
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Cassette interface 


7-pin DIN 
socket 
viewed from 
outside of 
case 


PIN 

OUTPUT TO CASSETTE (RECORD) LINKED TO PIN 4 
COMMON 

INPUT FROM CASSETTE (PLAY) 

OUTPUT TO CASSETTE (RECORD) LINKED TO PIN 1 
NOT CONNECTED 

MOTOR CONTROL SWITCH 

MOTOR CONTROL SWITCH 


NSA we 


To help you out of immediate difficulties however: if your cassette 
recorder has a 5-pin DIN socket for record/playback, then you can use a 
standard 5-pin DIN to 5-pin DIN lead between the Electron and the 
cassette recorder. The only disadvantage of this is that the Electron will 
not be able to control the cassette recorder’s motor (assuming that your 
cassette recorder has the facility for externally pausing the tape while it’s 
playing). This facility isn’t absolutely necessary, but it does mean that 
instead of the Electron stopping and starting the tape automatically, you 
will have to do it manually. 


Tf you find that you are listening to the Introductory Cassette via the 
cassette machine’s internal speaker, you may want to insert a plug into 
the earphone or external loudspeaker socket to stop it — computer 
programs sound like a screeching noise which is not pleasant! If in doubt, 
ask your local hi-fi dealer how to do this on your particular machine. 


Motor control 


If your cassette recorder has a motor control facility and you are using it, 
then you can ignore any messages asking you to stop the tape — this will 
be handled by the Electron automatically. All you need to do is to press 
the PLAY button on the cassette recorder when you first start loading 
the first program (explained in chapter 4) and leave it on. 


If your cassette recorder does not have motor control, then you must stop 
the tape as indicated by the computer. 


You are now ready to use the Introductory Cassette. 


4 The Introductory 
Cassette 


The Introductory Cassette contains lots of interesting demonstration 
programs which are recorded on both sides of the cassette. If you start at 
the beginning of side A and follow the directions in this chapter, the 
computer will take you through each of these programs in turn. When you 
get to the last program on side A, you will be asked to turn the cassette 
over and continue on side B. 


You will notice that the programs on side B start about a third of the way 
along the tape. The reason for this is that there are four extra programs at 
the beginning of side B and at the very end of side A which relate to the 
book Start Programming with the Electron. When you have got more 
familiar with your Electron and start using this book, then rewind the 
tape to the beginning of side B and follow the directions given in the 
book. 


This chapter deals with the demonstration programs only, so insert the 
cassette into your cassette recorder — side A uppermost. 


Adjusting the volume control and loading the first program 

On some cassette recorders, the volume control setting must be adjusted 
first before the Electron can ‘hear’ the programs being played. If this is 
the case for your machine, set the cassette recorder volume control to 
about two-thirds maximum, and the tone control (if fitted) to maximum. 
See if the yellow light on the left of the keyboard is on, and if it isn’t press 
the key and the key down together — this will make the 
yellow light come on. Press to ensure that the computer is 
completely reset. Now type the following exactly as it is printed below. 


CHAIN “INTRO” 


To type each quotation mark, hold your finger on the EXIM key and 
press the key with the number 2 on it (immediately above the 2 is the” 
character). Make sure you type an ‘O’ and not a zero. 


Then press G1SMUiL§. If you make a mess of it, don’t worry — just press 
and try again. 
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Press PLAY on the cassette recorder, and the tape should start moving. 
The message 


Searching 


should appear on the screen. This means that the computer is looking for 
the program called “INTRO” on the cassette. As soon as it has found it, 
you should see this message displayed on the screen: 


Loading 
INTRO i") 


This means that the program called INTRO has been found, and the 
computer is loading it (copying it) into its memory. The program is 
recorded in ‘blocks’ on the cassette, and the numbers on the screen next 
to INTRO tell you which block is being loaded at the moment. 


If the message above doesn’t appear on the screen after about 30 
seconds from pressing PLAY, then turn the volume control up a bit more, 
and wait for about ten seconds. If there’s still no message, turn it up more 
and keep on until you get a message similar to the one above. 


The two numbers to the right of INTRO will be higher than @@ by this time, 
so completely rewind the tape and start again. Press LULZ and retype 


CHAIN “INTRO" [Gigs 


Now that you have found the right setting for the volume control, there is 
no need to adjust it again. 


Once INTRO has been loaded successfully, four numbers appear to the 
right of the two numbers already there. When this happens, it means that 
the program has finished loading, so unless the Electron has done it for 
you already, stop the tape. If you don’t, then you'll have to rewind the 
tape back to the end of the INTRO program before the Electron can load 
the next program. If for any reason the program did not load successfully, 
a message will appear telling you to rewind the tape and start again. 


After a short pause, the INTRO program starts running. 


The INTRO program uses some of the colour graphics and sound 
capabilities of the Electron, and also includes an index of the programs 
you are about to see on side A of the Introductory Cassette. 
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Here is a quick guide to the other demonstration programs: 


KEYBOARD 

This program will help you to get to know the Electron’s keyboard. You 
will be asked to type different characters from the keyboard. So that you 
can judge your performance and see how you improve, the computer 
times you! 


SKETCH 

Feeling creative? Here’s a chance to put your artistic talents to use. In the 
centre of the screen there is a cross which you can move wherever you 
like. As the cross moves, it draws a line in the colour of your choice. You 
can also move the cross without drawing a line — rather like lifting your 
pen off the paper-—and then carry on. The keys you can use and what they 
do are listed at the bottom of the screen. 


PIANO 

The Electron turns itself into a musical instrument, At the bottom of the 
screen there’s a picture of a piano keyboard with the corresponding keys 
on the Electron keyboard shown. At the top of the screen, the musical 
score appears as you play. 


DODGEMS 

You are in control of a car driving through a maze of roads which each 
contain a row of dots. You must drive along every road and clear the dots 
on them to score the maximum number of points. Unfortunately, there’s 
acomputer car coming the other way whose sole purpose in life isto crash 
into you! 


You control the car with five keys which are described at the beginning of 
the game, and these allow your car to: 


— Go left 

— Go right 

— Go up 

— Go down 
— Go faster 


If you are going too fast, you have to turn at every junction unless you 
slow down in time. 


You score one point per dot and one more when they’re all gone. Once 
there are no dots left, a new maze appears and you carry on as before — 
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only this time the computer car travels faster! 


BIORHYTHMS 

This ingenious program plots your ‘biorhythms’ which is the supposed 
balance between your emotional, physical and intellectual states. Some 
people believe that these are regular cycles which show when you are at 
your best and worst physically, emotionally and intellectually. They also 
believe that the rhythms started at birth and can be predicted mathe- 
matically. 


All you need to do is enter your date of birth and the date you would like 
the biorhythm chart for— perhaps today, or maybe you have an important 
event coming soon, and you want to find out how you'll feel on that day. 


The program calculates these cycles from your birth and then displays a 
chart which indicates your state of well-being on the chosen day. 
Biorhythms or no biorhythms, this program demonstrates the com- 
puter’s calculation speed (for example, the number of days from your 
birth) and how the computer can be used to display graphical informa- 
tion. 


CLOCK 

This program shows that the computer has more of a memory than you 
think. Remember the computer asked you the time in the INTRO 
program? If you typed in the correct time then, you can check it now — 
either as a digital or analogue read-out. You can even reset it if you want. 
As well as demonstrating the Electron’s high resolution graphics, this 
program also shows that the computer is an excellent time-keeper. 


GOMOKU 

Gomoku is a very old board game where two opponents (you and the 
Electron) try to produce a row, column or diagonal with five counters. It 
is really a sophisticated version of noughts and crosses where you must 
plan your moves carefully — there is a very large number of possible 
moves. 


The game starts with a blank screen and the message 


SHALL I START? 
Press Y or N 


After you've pressed Y or N, the board appears on the screen, and if you 
let the computer have first go it will have placed its counter somewhere 
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on the board. 


A small cross shows where your counter will be placed. Once you are 


happy with the position for your counter, press HIAMLVJ, and a counter 
appears in place of the cross. 


The computer has another go and play continues until one of you 
manages to get an unbroken line of five counters on the board. The 
winning line flashes for a few seconds, and if you want another game, 
press the space bar. 


MESSAGE 

This program tells you to stop the tape (if you haven’t got motor control), 
and continue on side B of the cassette where you will find the programs 
described below. 


PATTERNS 

This program generates kaleidoscopic patterns in colour, and no two 
patterns are ever quite the same. To start a new pattern, press the keys 
marked 1 and 2 in sequence. The pattern itself and its colours are 
randomly selected each time the keys are pressed and serve to 
demonstrate the Electron’s high resolution colour graphics. If you want 
to sit back and watch, press one of the keys for a second or two; the 
computer will continue to generate the patterns until the repeat action of 
the key you pressed runs out. 


MARSLANDER 

You are in command of a spacecraft which you must try to land on a flat 
section of the Martian terrain as gently as possible. Key X rotates the 
craft clockwise, and key Y anticlockwise. The space bar fires the rocket 
motor and makes the spacecraft move in whatever direction it is 
pointing. To land the spacecraft safely, it must be pointing upwards, at a 
speed of less than 5#m/s and you must touch down on a flat section of 
Mars. The score depends on your speed when you land, with a possible 
5900 points for landing at (m/s. After a successful landing, the computer 
will tell you what sort of landing you made, your touch-down speed, how 
much fuel you have left, and ask you to take off for another landing site 
which is more than a specified distance away. On each successful 


* landing, you get 3@ extra fuel units and your old score is added to your 


new one. 
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BUGZAP 

This program gives you some target practice shooting down a space 
invader. The keys on the keyboard marked Z and X move the launcher, 
and the space bar fires missiles at the space invader. Good luck! 


ISLAND 


This program draws a colour picture of a desert island with palm trees, 
and a moving sea which occasionally becomes turbulent. This program 
demonstrates the use of animation in graphics. 


PLANETS 

This is a very striking example of high resolution colour graphics on the 
Electron, where animation is used to produce a marked three-dimen- 
sional effect. 


Loading each program from the cassette 


If you simply follow the instructions on the screen, you will be loading 
each program into the Electron’s memory one after the other, If you want 
to locate a particular program on the cassette, wind the tape to any point 
before the program you want (a tape counter can be of great help here) 
and type 


CHAIN "XXXX" (where XXXX represents the program name) 


Then press the G40 G0] key. The computer will look through the tape 
until the program name is found, then it will start loading the program, 
and afterwards, run it. 


Alternatively, position the tape just before the beginning of the program 
you want, and type 


CHAIN "" 


Then press the key. The computer will load and run the next 
program it finds on the tape. To help you find the beginning of a program, 
listen to the tape; each program sounds like a screeching noise, and 
between programs you will hear a continuous high-pitched tone. If you 
start loading during the high-pitched tone then you know you're in the 
right place. 
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There are two important points to bear in mind. The first is that the word 
CHAIN is a command which tells the computer to load the program you 
specify and then to execute it (run it). So in fact the CHAIN command tells 
the computer to do two things. The second point is that when the 
computer is searching for the program you specified, it will still display 
on the screen the name of whatever program is currently playing. This 
should give you an idea of how close you are to the program you want. 
However, remember that whatever program is displayed on the screen, 
the computer isn’t loading it unless you see the word 


Loading 


above the program name. Don’t be fooled into thinking that just because 
a program name appears on the screen, it is being loaded (copied) into 
the Electron’s memory. 


Chapters 9 and 26 give a detailed account of all the facilities made 
available to you by the Electron when recording (saving) and playing 
back (loading) programs to and from cassette. 


5 How to use the 
keyboard 


Introduction 


The Electron keyboard works rather like an ordinary typewriter key- 
board. The main difference is that when you press a key, instead of 
letters appearing on a sheet of paper, they appear on your television 
screen, 


The small white flashing line you can see on your TV screen is called the 
CURSOR and it shows where the next character to be typed will appear 
on the screen. 


One thing to bear in mind which the keyboard doesn’t make obvious— the 
keys which produce the letters of the alphabet 


QWERTYUIOP 
ASDFGHJKL 
ZXCVBNM 


can be made to produce small letters as well as capital letters. 


As you can see, virtually all the keys have more than one character/word 
printed on them — some even have three! There are four keys on the 
keyboard whose purpose is to sort out which one appears on the screen 
when you press a particular key. These are 


Silas §— there are two of these keys 

CTRL 

CEES /GTTA «— this is one key, which is normally ‘FUNC’ but is 
‘CAPS LK’ when used with the SHIFT key. 


These keys are used in various combinations to give you the character or 
word you want to appear on the screen, and this is described shortly. 


The EXLZL§ key clears the screen and prepares the computer for 
entering a new program. Any program lines already entered will be 
deleted (but can be recovered by using the OLD command - see chapter 
25). 
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Holding down the [4U1§ key then pressing the BUZL@ key clears the 
screen and restores the computer to how it was when you first switched it 
on. 


The | ESCAPE | key is used to interrupt a sequence of events generated by 
the Electron, such as a program listing or program execution etc. 


The L7adai9 key moves the cursor backwards along a line and deletes 
whatever character it finds there. 


Choosing the keyboard characters 


This section tells you how to select all the different characters on the 
keyboard. 


SHIFT and CAPS LK 


Press the BUUag key, and hold it down while pressing the HAGHRG/ 
key. If you keep on doing this, you will notice that the yellow light to the 
left of the keyboard goes on and off. 


When the light is on, the keyboard is in ‘CAPS LOCK’, and this means 
that pressing letter keys will give you capital letters, but all other keys 
will give you the lower of the two black characters on the top of the key. 


When the light is off, the keyboard is no longer in ‘CAPS LOCK’ — the 
only difference is that the letter keys will give you small letters when 
pressed. 


SHIFT 


With the yellow light off, press the key, and hold it down while 
you press one of the character keys. All letters appear on the screen as 
capitals, and all the keys with two black characters marked on them make 
the upper character appear on the screen. The keys with three black 
characters marked on them make the top left character appear on the 
sereen, 


With the yellow light on, press the jiag key, and hold it down while 
you press one of the character keys. Even though the keyboard is in 
‘CAPS LOCK’, all letters appear on the screen as small letters. 
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FUNC 


A lot of keys have light brown characters marked on the front, such as 
GOTO, RUN, f7 etc. Press the /a key and hold it down: at the same 
time, press the key with PRINT marked on the front. The word PRINT 
appears on the screen. Try pressing the / | FUNC | key with some of the 
other keys with light brown writing on them. 


You probably noticed that the keys marked ‘f@ to ‘£9’ won't do anything 
when you press them. This is because they are ‘user definable’ keys 
which means that you can choose what they will do when they are 
pressed. How you define them is described in chapter 24. 


If you have never come across the computer language called ‘BASIC’, 
you may wonder what the point is of being able immediately to display 
these words on your TV screen. The answer is simple; the Electron 
computer understands and uses the ‘BASIC’ language, and these words 
are the most common ‘keywords’ (or commands) in this language, so 
rather than having to keep on typing these out in full, you can simply 
press the / I[Tq key and the relevant character key. This saves a lot of 
time when typing lengthy programs into the computer. 


The arrow keys and the COPY key 


There are five keys in the top right area of the keyboard which have three 
black symbols marked on them (four of the keys have arrows on them, 
and one of them the word | COPY )y First of all, here is how to select which 
symbol you want from any of these keys: 


For example, the key marked 


N™ 


~~ 
Key by itself selects left arrow (which moves the cursor) 
Siijiag and key selects \ and produces it on the screen 
(atii§ and key selects ~. and produces it on the screen 


What the arrow and COPY functions do 
If you press any of the keys marked with arrows, the cursor moves in the 
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direction of the arrow, and leaves a square block where it was before it 
moved. 


If you now press the key, both the ‘line’ cursor and the ‘block’ 
cursor move across the screen, and every character above the ‘line’ 
cursor is copied to where the ‘block’ cursor is. This is a very useful facility 
for editing programs: the idea is to copy the line with a mistake in it ontoa 
fresh line, and correct the mistake(s) while you’re doing it. Editing 
programs using this facility is described in chapter 7. 


Summary 


1. CAPS LOCK off (yellow light off) 
Small letters and bottom black characters 


2. CAPS LOCK on (yellow light on) 
Capital letters, otherwise as above 


3. CAPS LOCK on (yellow light on) with key 
Small letters and top (left) black characters 


4, CAPS LOCK on or off /GUXYY with key 
BASIC keywords, as indicated on the front of the keys, are produced 


5. CAPS LOCK on or off agg with key 
Selects top right hand character from keys with three black characters 
marked on them. 


Note: See Appendix A for a list of VDU control codes which can be 
generated by pressing [419 and some of the other keys on the 
keyboard. 


6 Introducing 
commands and 
programs 


The Electron computer, like any computer, has to be told what to do 
before it will do anything for you. The only way you can ‘talk’ to it is by 
typing commands to it on the keyboard, and the Electron tells you what 
you typed by displaying it on the TV screen. 


The Electron understands two languages, one called BASIC and the 
other called Assembly Language. As these are written languages only — in 
other words they are meant to be typed into the computer rather than 
spoken to it— they each have their own special vocabulary and grammar. 


Talking to the computer in Assembly Language is no easy task for the 
beginner so it is discussed in a separate section towards the end of this 
book. From now on, we will be helping you to speak to your computer in 
the language called BASIC. This language consists of a number of words 
or commands. Some of these are printed on your Electron keyboard in 
light brown letters. 


Note that the Electron displays a > sign followed by the flashing cursor. 
This is called a ‘prompt’, and means that the computer is waiting for your 
instructions. Normally the Electron will prompt you when it is waiting for 
you to type something in. The > prompt means that the Electron is 
expecting a BASIC command. 


Press the ELJZLG key to clear the screen, and type the following line 
PRINT "HELLO" 


Then press GLasUGL. As soon as you press the GiQMUih'} key, the 
computer obeys the BASIC command PRINT, and because the rest of the 
line was in quotation marks it displayed the word HELLO on the screen. 


Now type this 
PRINT “I'M” 


PRINT "LEARNING" 
PRINT “BASIC" 
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#**DON’T FORGET TO PRESS THE (33002) KEY AT THE END 
OF EACH LINE!*#* 


As you can see, the Electron reads each command and executes it 
immediately after you press the key. You can also type in all 
these commands first AND THEN make the computer execute them 
when you tell it to do so. This is done by putting a number in front of each 
instruction. 


Now type the following 


16 PRINT "HELLO" 

2@ PRINT "I'M" 

3@ PRINT "LEARNING" 
4@ PRINT "BASIC" 


**DON’T FORGET TO PRESS THE GiaQGhy KEY AT THE END 
OF EACH LINE!*** 


The computer hasn’t carried out your instructions like it did before, so 
now type 


RUN 


Followed by the Giatiig key. 


This time the computer has printed your message on the screen all in one 
go. 


Congratulations, you have just run your first program on the Electron 
Microcomputer! 


So a program is simply a collection of numbered instructions. The line 
numbering has two purposes: firstly to tell the computer not to execute 
each line after you have pressed the key, and secondly to help 
the computer decide in what order it should execute the instructions — 
after you have typed RUN of course. 


The actual numbers you type in can be any numbers you like as long as 
you remember that the computer will execute the program lines in 
numerical order. 


The chapters which now follow serve as an introduction to the Electron 
BASIC language, and how to use the facilities it offers you. The chapter 
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on editing your programs will help you speed up the process of typing in 
programs and making changes to get them working. 


Unlike a typewriter, you dont need to press the key when what 
you have typed has filled up the current line on the screen — just carry on 
typing. What happens is that the computer starts a new line on the 
screen, and the subsequent characters you type are displayed on the new 
line. Prove this to yourself by typing a lot of characters. 


Remember that pressing the key tells the computer that you 
have reached the end of the command or program line you have just 
typed. If a command, the computer then executes it, and if a program 
line, the computer stores it in its memory. 


What is hexadecimal? 


Once you get more familiar with the Electron, you may come across 
things called ‘hexadecimal’ numbers. Here is a brief explanation of what 
they are. 


Hexadecimal numbers, sometimes called ‘hex’ numbers for short, have 
sixteen separate digits, compared to our decimal numbers which only 
have ten (including the number zero). This is how you count in 
hexadecimal, with the decimal equivalent underneath. 


96128 456789 ABCODE F 191112... 
612 3 4 5 6 7 8 9 191112131415 1617 18... 


To show you how to carry on counting in hexadecimal: 

12 13 14...19 1A 1B 1C 1D 1E IF 2@...2F 39... 
BF 49...... 99...9F A@ Al A2...AF B@...BF C@ 
FF 166 191... ete 


To help you and the Electron tell the difference between decimal 
numbers and hexadecimal numbers, you should always type an ‘&’ signin 
front of a hexadecimal number. If you don’t, then the computer will 
assume your number to be a decimal. So we can now say &AG = 160 
(hexadecimal A@ is equal to decimal 169). 


7 Editing programs 


Introduction 


The Electron provides you with a number of very useful facilities for 
laying out, editing and listing your programs. If you haven’t done any pro- 
gramming before, here is a brief list of the sort of facilities you will need 
when typing in programs and making them work: 


— Being able to display part or the whole of your program on the screen 
whenever you want to. 

— Correcting mistakes, or editing. 

— Putting comments or notes into the program to help you remember 
what each part of the program is doing. 

— Deleting one or more program lines. 


To start looking at these facilities and how to use them, type in the 
sample program below which we will use to demonstrate the different 
facilities. 

First, press EQLZL@ to clear the screen and reset the computer, then 


type the following, and take care with the punctuation and spaces in the 
last line. 


1@ PRINT "GIVE ME A NUMBER BETWEEN ONE AND 
TEN” 

20 INPUT X 

30 Y=2*X 

40 PRINT "TWO TIMES "3X;" IS ";Y 


After typing in the above program, type 
RUN Gia 


When you run this program, the following happens 


line 19 GIVE ME A NUMBER BETWEEN ONE AND TEN appears on the 
screen 

line 26 A question mark appears on the line below, and the computer 
waits for you to type in a number which is stored as a variable 


called X. Type in a number and press U3 MUih 
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line 36 The computer multiplies X by 2 and stores the result as a 
variable called Y 

line 49 The following is printed on the screen: TWO TIMES (the number 
you typed in) IS (the result) 


Tf the program won’t work properly, or you get an error message, press 
and type it in again — you most likely made a mistake when you 
typed it in the first time. 


Listing the program 


When you want to change your program in any way, you will need to 
display the program (or at least the bit you want) on the screen. To do 
this, use the BASIC command LIST. Type 


LIST Gis 


Your program appears immediately underneath the LIST command on 
the screen. 


If you only want to look at one particular line, say line 49, type 


LIst 40 (GiatUGh! 


Line 4@ of your program is displayed on the screen. 


To look at a number of consecutive lines, say lines 2¢ to 4@, type 


LIST 20,40 [iatuil 


Lines 20, 34 and 49 appear on the screen. 


If you want to see from the beginning of the program up to a particular 
line, say line 39, type 


List ,30 atid 


Lines 14, 29 and 3 appear on the screen. 


If you want to see from a particular line to the end of the program, then 
type 


LIST 20, Hiatal 
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Lines 24, 39 and 49 appear on the screen. 


Please refer to chapter 25 for a description of the LISTO commands. 
These commands provide you with even more facilities when listing 
programs, 


Editing programs 
There are three ways of correcting mistakes in programs you have typed. 


One of these you have already met in chapter 5: that is, pressing the 
key which moves the cursor back along the current line deleting 
each character as it goes, There is one major drawback to this method — if 
you have finished typing a line and have pressed | RETURN fl you can’t get 
the cursor to go back to that line by just pressing the [fgla,4 key. As we 
said before, pressing the key only moves the cursor back along 
the current line, which may not be the one you want to correct. 


Another method is to type in the line again, but with the correction. The 
computer always replaces the old program line with any new version you 
type in. If the line to be corrected is very short, then this method is fine; 
but if the line is long or complicated, then use the third method described 
below. 


Editing with the arrow keys and the COPY key 
Type 


LIST Dian 


The program appears on the screen, and we are going to use it to try out 
some editing. The following should now be on your screen: 


>LIST 


1@ PRINT “GIVE ME A NUMBER BETWEEN ONE A 
ND TEN” 

280 INPUT X 

3@ Y=2*X 

40 PRINT "TWO TIMES ";X;" IS "3Y 
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Supposing you want to change the word BETWEEN to FROM in line 19. 


First of all, press the up-arrow key five times. The original cursor position 
under line 49 becomes a white square, and the cursor moves up to line 19. 


Now press the key marked three or four times. The cursor moves 
along line 19, the white square moves along as well — and line 19 is copied 
underneath line 49. Keep on pressing the key until you have 
copied the word BETWEEN, then stop. Note that if you hold the key down, 
the repeat action allows you to move the cursor quickly across the screen. 
A quick press and release gives you precise control, moving just one 
character position. The following should be on your screen: 


>LIST 

1@ PRINT "GIVE ME A NUMBER BETWEEN_ONE A 
ND TEN" 

20 INPUT X 

38 Y=2*X 

4G PRINT “TWO TIMES ";X;" IS "ZY 
> 10 PRINT “GIVE ME A NUMBER BETWEEN 


Now press [Jq¥af¥ until BETWEEN has been deleted from the new line 
16. 


NOTE THAT THE CURSOR ON THE OLD LINE 16 HASN’T 
MOVED. 


If the cursor isn’t in the right place, ie underneath the space separating 
BETWEEN and ONE, move it there now by using the arrow keys. 


Now type in the word FROM, then press the [Ag key to copy the rest of 
line 19 to your new version. 


Press GJ40G0). The white square disappears, and the cursor goes to the 
start of a new line. The result should be this: 


>LIST 
10 PRINT "GIVE ME A NUMBER BETWEEN ONE A 
ND TEN" 
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20 INPUT Xx 
3@ Y=2*x 
40 PRINT "TWO TIMES ";X;" IS “;Y 


10 PRINT “GIVE ME A NUMBER FROM ONE AND 
TEN" 
> 


Tf you LIST the program again, by typing 


LIST Giaeiiiy 


you will see that the new line 1 has replaced the old version. Have a goat 
editing line 19 again and change AND to TO. 


There are no restrictions on how much you move the cursor around when 
you’re copying. This means that you can copy bits from lots of different 
lines onto your new line all in one go: wherever you move the cursor to by 
using the arrow keys, you can then copy as much as you like of that line, 
then move the cursor somewhere else and continue copying. 


Deleting lines from your program 
There are two ways of deleting whole lines from your program. 


The first method is to type in the line number of the line you want to 
delete, then press | RETURN F What you are doing is entering a new 
version of that line into the computer — only with nothing in it. Because 
the computer always replaces a previous version of a line with any new 
version you type in, this method effectively deletes that line number. 


For example, to delete line 19 of the program, type 


10 GEE 


Now list the program by typing 


esas RETURN 


And you will see that line 1@ has been deleted. Now type the original line 
19 again so that it goes back into your program. 
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The second method of deleting program lines is to use the DELETE 


command. This command allows you to delete a number of consecutive 
lines. 


To do this, type DELETE, then type the first line number to be deleted, 
then a comma, followed by the last line to be deleted. The following 
examples will help you understand, but before typing them into the 
computer, remember that they will in fact delete parts of your program, 
so afterwards you will need to type the deleted lines again to restore your 
program! 


First of all, list your program so that you can see it on the screen. You 
should have lines 19, 24, 34 and 49. If not, then replace the missing ones 
(copy them from the program listing at the beginning of this chapter). 


To delete lines 19, 24 and 39, type 
DELETE 10,308 Glau 


To delete all lines from the beginning of the program to a particular line 
number, type @ followed by a comma followed by the last line to be 
deleted. For example, to delete lines 19, 26 and 39, type 


DELETE 0,30 Gigi! 


To delete all lines from a particular line to the end of the program, the 
numbers to enter after the DELETE command should be the first line 
number to be deleted, then a comma and then any number which you 
know to be equal to or greater than the last line number of the program. 
For example, to delete line 24 onwards, type 


DELETE 26,100 [iat 


Inserting new lines into your program 
First of all, list your program (if you haven't deleted it all!) and type in any 
lines which may be missing. 


Having typed in the first attempt of a program, executed it by using the 
RUN command, and changed or deleted lines as necessary to make the 
program work, you may want to insert new lines. You will then see how 
important it was to leave plenty of unused line numbers between the 
original lines in your program. To insert new lines, decide when you want 
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the new line to be executed by the computer when it runs the program, 
then choose a suitable line number. For example, to insert a line which 
makes the computer print another message underneath GIVE ME A 
NUMBER FROM ONE TO TEN, you will need to insert a new line 
somewhere between lines 19 and 29. Let’s choose 15; this still leaves 
some room either side for any more new lines, so now type 


15 PRINT “NICE DAY ISN'T IT" Gigi 


Now list the program, and you will see that the new line appears in the 
listing. The listing should look like this 


10 PRINT "GIVE ME A NUMBER FROM ONE TO TEN" 
15 PRINT "NICE DAY ISN'T IT" 

20 INPUT X 

30 Y=2*X 

4@ PRINT “TWO TIMES ";X;" IS "ZY 


Make the computer execute the program by typing 


RUN GU 


and type a number for it to multiply by two. Remember that the 
computer is expecting a numeral and will not recognise letters. This is 
because our little program would need some more lines adding to it 
before the computer would recognise THREE instead of 3, or TEN 
instead of 19. 


Renumbering the program 

There may be occasions when you want to change the line numbers of a 
program but without changing the order in which they are executed by 
the computer. The command which does this is RENUMBER. This facility 
is especially useful when you want to insert say 25 new program lines 
between lines 14 and 29 in your existing program. 


You can specify two numbers after typing the RENUMBER command. 
The first number tells the computer what you want the first program line 
number to be changed to, and the second number tells the computer how 
much to add to each line number to get the next one. 


For example 
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RENUMBER 180,20 Eiaciii) 
will renumber the first line as line 199, and the remaining lines will be 
numbered 129, 149, 169, and so on. 


If you leave out the second number in the RENUMBER command, the 
computer will automatically change the second line number to ten more 
than the first, and then carry on through the listing. So if you had a 
program with line numbers 


23 PRINT "The Electron" 

24 PRINT "Microcomputer" 

26 PRINT “will do" 

3@ PRINT "many things for you" 


and type 

RENUMBER 100 Siaguii) 

listing the program will give 

100 PRINT "The Electron” 

110 PRINT “Microcomputer” 

12@ PRINT “will do" 

130 PRINT “many things for you" 

If you simply type 

RENUMBER Giggii) 

then your program lines will be renumbered 14, 29, 30, 40, 59 and so on. 
Getting the computer to number each program line 


Instead of typing line numbers at the beginning of each new program line, 
you can get the computer to do this for you by using the command AUTO. 


If you type 


AUTO Gigi 


you will see that the computer will print the number 14 on the line below. 
You can then type the first program line, press 4 iin] at the end, and 
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the number 29 appears on the next line — and so on. When you want to 
switch off this automatic line numbering, press 


If you don’t want to start the program at line 14, and want a different 
number of spare lines between each of your program lines, then you can 
type in two numbers — separated by a comma ~ after the AUTO command. 
For example, if you type 


AUTO 406,15 Giagit 


the program line numbers will come out as 400, 415, 439, 445 and so on. 


Now press EQIZNG, and retype the example program we were using 
previously using the AUTO facility. Start the program numbering at 299 
and continue in steps of 59. 


Putting notes into your programs 

When typing programs, especially long ones, it is a good idea to insert 
comments here and there to tell you what each part of the program is 
doing. This is done by using the REM command. All REM does is tell the 
computer to ignore the rest of the line when it executes the program, but 
your comments will still appear in the program listing when you give the 
command LIST, 


For example, we could insert a comment at the beginning of our example 
program to tell us what the purpose of the program is, like ‘This program 
doubles numbers’. To insert this into the program listing, first type 


LIST Badihy 


to get a listing of the program. Then choose a line number less than the 
first program line, say 5. Now type 


5S REM This program doubles numbers [igi 


If you list the program, then run it, you will see that the comment in line 5 
appears in the listing, but is ignored when the program is executed. 


Retrieving a program and starting a new one 
If you press the EULELG key for any reason, the program you have typed 
in so far gets ‘lost’. To get it back again, type 


LE RETURN 
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If you want to start a new program, make sure that any program already 
stored in the computer has been deleted. In other words, type 


LIST Gilat 
and if a program appears, then delete it by typing 


NEW Gh! 


You can now enter your new program, and the old one is forgotten. 


Listing long programs 


When listing very large programs, which won't fit on the screen ail in one 
go, the beginning of the listing will disappear off the top of the screen. 
There are two ways of getting round this: one way is to press PAGI9 and 
together as soon as you have typed 


eam RETURN 


The effect of this is to halt the displayed listing on the screen. Taking 
your finger off either [Gi9 or allows the listing to continue, and 
this enables you to ‘step’ through chunks of the listing. 


The other method is to put the Electron into ‘paged mode’. Press 
N to get into ‘paged mode’, then list the program. The listing stops as 
soon as it has filled the whole screen. To display the next ‘screenful’ of 
listing, press the key. 


Press (4GI§ O to get out of paged mode. 


8 Trying out some 
programs 


Introduction 


Having seen something of what the Electron can do, and having got used 
to typing on the keyboard, it’s now your turn to tell the Electron to do 
things. Because the computer does exactly what it is told, remember to 
type in the examples given exactly as they appear in this chapter. You'll 
find that you can sometimes get away with adding an extra space here 
and there or leaving one out, but rather wait until you are more familiar 
with the Electron BASIC language before experimenting! After you have 
typed in each program, type 


iU as RETURN 


to execute it. If the program doesn’t appear to work, the computer may 
help you by displaying an error message, and telling you in which line the 
mistake appears. Press and list the program as described in the 
chapter on editing. Make the necessary alterations, then run the program 
again. 


Before you start, press the key marked [EG{2.g on the keyboard. This 
will get the computer ready for you, and also start you off with an empty 
screen. 


PERSIAN 

This program produces a pattern by drawing hundreds of lines. Random 
colours are selected by lines 49 and 59. Line 69 moves the origin (middle) 
of the picture to the centre of the screen. The program stops after a while, 
so run it again to repeat the patterns. 


10 REM PERSIAN 

2@ MODE 1 

3G D%=4 

4G VDU 19,2,RND(3)+1,0,0,0, 

50 VDU 19,3,RND(3)+4,0,0,0 

6G VOU 29,648; 512; 

70 J1%=0 

8@ FOR K%=50@ TO 388 STEP -48 

9@ REPEAT J2%=RND(3): UNTIL J2%<> J1% 
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100 J1%=J2% 

11@ GCOL 3,J1% 

12@ FOR I%=-K% TO KX STEP D% 
130 MOVE K%,1% 

140 DRAW -K%,-1% 

150 MOVE 1%,-K% 

160 DRAW -I1%,K% 

170 NEXT 

180 NEXT 


POLYGON 

This program draws polygons (many sided shapes) in random colours. 
Lines 94 to 159 select a random place on the screen which will be the 
centre (origin) of the next shape. 

Lines 17¢ to 259 calculate the X and Y coordinates of each corner of the 
polygon and store the values in two ‘arrays’ for future use. 

Lines 22@ and 16@ fill the shape with black triangles which make it 
appear as if the new polygon is in front of the older ones. 

Lines 26¢ to 31@ draw all the lines that make up the polygon. 

Lines 30 to 59 set the actual colours of logical colours 1, 2 and 3 to red, 
blue and yellow. You can change these to use other colours if you like. 
Unlike the PERSIAN program, this one carries on and on until you stop 
it yourself. To do this, either press | ESCAPE | or EQNG. 


10 REM POLYGON 


28 MODE 14 

30 VDU 19,1,1,0,0,8 
40 VDU 19,2,4,0,0,0 
5@ VDU 19,3,3,0,08,08 


6@ DIM X¢18) 

70 DIM Y(1@) 

8@ FOR C=1 TO 2500 

98 xorigin=RND (1206) 
100 yorigin=RND(1600) 
110 VDU 29,xorigin;yorigin; 
12@ radius=RND(300)+50 
130 sides=RND(8)+2 

148 MOVE radius,@ 

15@ MOVE 10,10 

168 GCOL G,@ 

178 FOR SIDE=1 TO sides 


36 Trying out some programs 


180 angle=(SIDE-1)*2*PI/sides 
198 X(SIDE)=radius*COS (angle) 
208 YCSIDE)=radius*SIN(angle) 
210 MOVE @, 

220 PLOT 85,X (SIDE) ,Y (SIDE) 
23@ NEXT SIDE 

248 MOVE @,0 

25@ PLOT 85,radius,9@ 

266 GCOL @,RND(3) 

278 FOR SIDE=1 TO sides 

280 FOR Line=SIDE TO sides 
290 MOVE X(SIDE),Y (SIDE) 

30@ DRAW X(Line),Y (Line) 

310 NEXT Line 

32@ NEXT SIDE 

330 NEXT C 


DRAW 

This program is a simpler version of the SKETCH program on the 
Introductory Cassette. The main part of the program is between lines 20 
and 229, and two procedures are called from here. 

Lines 246 to 29¢ print the instructions at the bottom of the screen. 
Lines 32 to 369 limit the graphics area you can draw in, and contain the 
DRAW instruction. 

Lines 139 to 209 define which keys on the keyboard are ‘drawing’ keys, 
and set the values for X and Y for each key. These values are used later 
on by line 369. 

Note that line 4@ turns the cursor off, so when you’ve finished drawing 
masterpieces, press | ESCAPE | and type 


VOU 23,1,1;0;0;30; Elan 
Alternatively, just press EIVEU@. 


1@ REM DRAW 

2@ MODE1 

30 PROCKEY 

40 VDU 23,1,0;0;0;0; 
5@ GCOL @,1 


6G 

98 
100 
116 
120 
130 
140 
150 
160 
178 
188 
196 
200 
210 
220 
236 
240 
2508 
266 
270 
280 
290 
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VDU 19,1,2,0,0,08 

X=640 

Y=512 

MOVE X,Y:DRAW X,Y 

REPEAT 

L=INKEY (-98) 

R=INKEY (-67) 

U=INKEY (-73) 

D=INKEY (-105) 

IF t=-1 THEN X=X—-4:PROCDRAW(X,Y) 
IF R=-1 THEN X=X+4:PROCDRAW(X,Y) 
IF U=-1 THEN Y=Y+4:PROCDRAW(X,Y) 
IF D=-1 THEN Y=Y-4:PROCDRAW(X,Y) 
UNTIL FALSE 

END 

DEF PROCKEY 

PRINT TAB(@,25) “Your Drawing keys are:" 
PRINT TAB(@,26) "“Z or z = Left" 
PRINT TAB(@,27) "X or x = Right” 
PRINT TAB(O,38) “* or: = 

PRINT TAB(@,29)"2? or / = 

PRINT TAB(Q@,30) "Press two keys for ad 


jagonal" 


300 
310 
320 
330 
340 
3508 
368 
370 


ENDPROC 

DEF PROCDRAW(X,Y) 

IF X<@ THEN X=0 

IF X>1279 THEN X=1279 
IF Y<25@ THEN Y= 25@ 
IF Y>1023 THEN Y=1023 
DRAW X,Y 

ENDPROC 


9 Recording programs 
on cassette 


As you have seen, the Introductory Cassette has a number of programs 
stored on it. You can record programs you have typed into the Electron 
onto cassette for future use. This is very useful for transferring other 
people’s programs from their cassette onto yours; for example, you might 
want to copy one particular program on the Introductory Cassette onto 
another cassette. Before you make any cassette copies of any programs, 
be sure that you are free to do so. The company or person who wrote the 
program may own the copyright to that program, in which case, written 
permission must first be applied for. 


The main thing to remember when you record programs is where the 
program that you’ve recorded can be found on the cassette, otherwise 
you will spend a lot of time searching. We strongly advise you to keep a 
piece of paper with each cassette, and to write down the name of each 
program and the tape counter position where it begins and ends. Bear in 
mind that when you record a program, it will record over the top of 
anything already on the tape; this is useful for erasing old programs you 
no longer need, but fatal if you record over the top of one you want to 
keep! 


Most short programs will only move the cassette tape counter on 39 or 4 
positions, but try to spread the programs over the length of the cassette. 
For example, record the first program at $9, the second at 149, the next 
at 249 and so on. This will make them easy to find, and will reduce 
the chances of overlapping recordings. The quickest way to find out if 
there’s a program at a particular point on the cassette is to play it back 
and listen to the cassette machine if you can. If there is a high pitched 
whistling noise, it means that a program is just about to start or just 
finishing. If you hear a screeching noise, you are listening to a program. 


One final point— when recording a program at the beginning of a cassette, 
wind the tape by hand until the clear plastic tape ‘leader’ is no longer 
visible. 


Saving (recording) a program on cassette 


Once you have typed a program into the Electron, then do the following 
to save it: 
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Insert the cassette into the cassette recorder. 
Set the tape counter to 649 when the tape is fully re-wound. 
Type 


SAVE "MYPROG" [ahi 


The message 


RECORD then RETURN 


appears on the screen. 


Fast forward the cassette to the place where you want to record the 
program — this will be 160, 260 or 399 etc on the tape counter. Note 
that if you have cassette motor control, you cannot wind the tape unless 
you have executed a SAVE, LOAD or *CAT command (see below for *CAT). 


Start recording on the cassette machine, then press GLAMGLJ on the 
Electron. 


If you want to give up at any time, press | ESCAPE B 


While the program is being saved on the cassette, the name of the 
program, which is MYPROG appears on the screen along with some 
numbers, This means everything is going OK. When the computer is 
finished, the > will reappear, and the tape will stop automatically. If you 
don’t have cassette motor control then the tape will carry on, and you will 
have to press the STOP button on the cassette recorder after the > 
reappears. 


Checking a recording 


To check that the program is really on the cassette use the *CAT 
command described later in this chapter. If the recording went wrong for 
any reason, then just re-record it. 


In the example above, the program was called MYPROG, but you can 
make up any name you like — as long as it contains ten letters or less. 


Loading a program from cassette 


To load a program on cassette into the Electron’s memory, type 
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LOAD "“MYPROG" 

The message 

Searching 

will appear. Rewind the cassette to just before the beginning of the 


program, using the tape counter to help you get there. 


Check that the volume and tone controls are set correctly. If you are 
unsure about this, turn to chapter 3. 


Press the PLAY button on the cassette recorder. 


If the computer finds a program other than the one you asked for, it will 
display its name on the screen but won't load it. As soon as the computer 
finds the beginning of your program called MYPROG, the message 


Loading 


will appear, and this tells you the computer is now loading that program. 


When the program is loaded, the computer will print the > prompt on the 
screen, and will automatically stop the tape if you have motor control. If 
you haven't, then press the STOP button. 


Now the program is in the computer’s memory, type 


RUN Bai) 


and the computer executes the program. If you have read the chapter on 
the Introductory Cassette, you probably remember that we were using a 
different command to load the tape. This is the CHAIN command, and 
what it does is to tell the computer to first LOAD the program and then 
RUN it immediately afterwards. So if you type 


CHAIN "“MYPROG” Eiggiis 


this will save you having to type RUN after the program has loaded. 


LOADING AND SAVING SHOULD NORMALLY BE DONE IN 
MODE 4, 5 OR 6. 
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Cataloguing the tape 


To find out what programs are on the tape, type 
*CAT Diam 


then play the tape (from the beginning if you want). Better still, keep a 
record of what is on the tape because cataloguing the tape takes a long 
time. However, cataloguing the tape also lets the computer verify the 
information recorded. If there are any errors in the data on the tape, an 
error message will appear on the screen, and the cataloguing continues. 


What the numbers mean 
A typical catalogue might look like this 


MYPROG 00 0084 


GAME1 8 @88E 
GAME2 GA GABA 
fred 25 2545 


The program name (or ‘filename’) is followed by two ‘hexadecimal’ 
numhers which give the ‘block’ number. As described in chapter 4, each 
program is recorded as a series of ‘blocks’. See chapter 6 for an 
explanation of hexadecimal numbers. 


The last number on the line gives the ‘length’ of the file. 


Escape 


If you want to stop in the middle of a LOAD, CHAIN or SAVE, press 
ESCAPE You will probably get a 


Bad Program 
error appear on the screen. To get rid of this, type 


Nam RETURN 


For more information about using cassettes for storing programs, please 
turn to chapter 26. 


10 The FUNC key and 
BASIC keywords 


As mentioned in chapter 5 on the Electron keyboard, the | FUNC | key to 
the left of the keyboard may be used with many of the other keys to print 
complete BASIC keywords on the screen. For example, if you press 

L the keyword LIST appears. Each key used together with 
FUNC | will give a keyword as follows: 


AUTO 
RENUMBER 
COLOUR 
DRAW 
ELSE 
FOR 
GOTO 
DEG 
INPUT 
RAD 
CHAIN 
LIST 
MODE 
NEXT 
ol J 
PLOT 
LOCAL 
RUN 
STEP 
THEN 
UNTIL 
vou 
RESTORE 
PROC 
REPEAT 
END 
LOAD 
SAVE 
PRINT 


NK KEM CHMDOVOZZOCAGMCTTOPAODOWS 


~~ 
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OLD and RUN incorporate GJS0LT7 , thereby issuing a direct command. 
If you press R then the current program (if any) will run. 


| FUNC] may also be used with the numeric keys, which may be 
programmed to give any string you choose (see chapter 24). 


The action of | FUNC| with all the keys can be altered using operating 
system call *FX226 and *FX227 (see Appendix D). 


Another way in which to cut down on typing is to use the abbreviations 
given in the BASIC keyword alphabetical reference section in chapter 
25. 


11 Variables and 
expressions 


What is a variable? 


A variable is piece of memory which is given a name, like Fred or Number 
or X or Y or virtually anything you want, and this memory is set aside for 
storing information. It is rather like a box where you and the computer 
can put useful items of information until they are needed at a later stage. 
All the computer has to be told is what the box is called, and what kind of 
information it can expect to find inside. Not only that, but the contents of 
a box can be changed at any time; so the computer can go to the box to 
store information, retrieve it, use it, change it, then put it back inside 
again as many times as you instruct the computer to do so. 


There are three types of ‘boxes’ or variables which the computer can use, 
and these are used to store three types of information. Briefly, these are: 


~ A ‘real’ variable, which can store numbers or fractions, eg 123.654. 

— An ‘integer’ variable, which can store only whole numbers, eg 123. 

— A ‘string’ variable, which can store ‘strings’ of characters such as 
words, 


Each type is distinguished by the last character of the variable name. A 
name by itself, like BERT, signifies a real variable, BERT% an integer 
variable and BERT$ a string variable. 


Real variables 


Press ELUZLG and type the following program (the line numbers are 
shown, but you will not need to type them if you are using AUTO). 


>1@ PRINT 34+2,3-2,3%*2,3/2 
>20 A=3 
>30 B=2 
>4@ PRINT A+B,A-B,A*B,A/B 
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If you run this program, you will see that the numbers 


5 4 6 1.5 
5 1 6 4.5 
are printed on the screen. The first row shows the results of the 
calculations performed by the PRINT instruction. The second row again 


shows the results, except that this was arrived at by lines 24 to 4 which 
use real variables. 


Line 29 tells the computer that there is a variable in the program called 
A, and sets its current value to 3. 


Line 3¢ tells the computer that there is another variable called B, and its 
current value is 2. Now that the computer is aware of these two variables, 
you can tell it to use them in calculations. Thus in line 49, the computer 
looks for the number stored in each variable, performs the necessary 
calculations, and the PRINT instruction prints the results on the screen 
just like it did for line 19. 


Operators and expressions 


Things like 3 + 2, A*B, (PRED — 4)*B are called expressions. In general, 
an expression is a sequence of numbers and variables together with 
mathematical symbols like +, *, /, These symbols, which are called the 
‘arithmetic operators’, have their normal mathematical meaning, except 
that in BASIC, * is used for ‘multiply’ and / for ‘divide’. 


Here is a list of the arithmetic symbols or ‘operators’ used in Electron 
BASIC: 


+ addition 

- subtraction 

* multiplication 

/ division 

A raise to the power 


decimal point 


For a description of operator precedence, see chapter 12. 
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Rules for variable names 
The rules for naming variables are: 


— There must be no spaces in the name. 

— The name must start with a letter. 

— There must be no punctuation marks in the name and no arithmetic 
operators. Underline characters may be used. 

— The name must not begin with a BASIC keyword (such as LIST or 
RUN). 


All the following names are acceptable: 


X = 6.6 
SMALL = -3@ 
small = -60 
xy = 43 


height6 = 5/11 

William1 = 1866 

space_rocket_speed = 25.000 

Note that capital and small letters are regarded as different by Electron 


BASIC, so that SMALL and small are two different variables. Underlines 
take the place of spaces, which are not allowed. 


The following are not acceptable: 


6teen = 16 (begins with a number) 
TOTAL = 77 (begins with TO) 
see-saw = 16 (contains a minus sign) 
LOW LINE = 3.333 (contains a space) 


How! = 1 (contains punctuation mark) 
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A variable does not have to be specified in terms of numbers; it may be 
specified in terms of other variables, or a mixture of variables and 
numbers. A statement of the form ‘variable = expression’ is called an 
assignment statement: it assigns the value of the expression to the 
variable. For example: 


xX = Y 
Monday = Tomorrow 
AGE = HEIGHT - 100 


TALL = TALL + 1 


The last assignment of this group is very common. It has the effect of 
increasing the value of the variable TALL by 1. Itis read as ‘Add 1 to the 
number contained in TALL, and store it in TALL again’. 


Integer variables 


The variables described so far in this chapter are called real variables. 
This means that they can represent both whole numbers (integers) and 
decimal fractions. There are variables called integer variables which can 
be used on the Electron, and these are used for storing only whole 
numbers. They are signified by the % symbol after the variable name. For 
example, 


SCORE% = 20 
Hour% = 36008 
1% = -747 


A% to Z% 

The 26 integer variables A% to Z% are called resident integer variables, 
because they are not cleared when the program is RUN, or when NEW or 
is used. This means that values can be passed from one program 
to another. They also have special uses when you come to look at 
Assembly Language programming (see chapter 29). 
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Real versus integer variables 
The reasons for using integer variables are: 


— They occupy slightly less memory than do real variables. 

— They are absolutely accurate provided you do not let them get out of 
range. Real variables are only accurate to nine figures, 

— They are much quicker for the computer to process and carry out 
arithmetic functions. 


However: 


— Decimal fractions can only be stored in real variables. 

— Much larger and much smaller numbers can be stored in real 
variables, Real numbers can have values of up to approximately 
174,909,090,990,000,000,000,000,000,000,000,000,000 or 1.7 * 19% 
(though they are only accurate to the first nine numbers or nine 
significant figures). 


The range and accuracy of real and integer variables are shown in the 
following table: 


Integer Real 
Example 64 1.782 
Typical variables A% A 
Maximum size 2,147,483,647 1.7X 19% 
Accuracy absolute 9 sig figs 
Stored in 32 bits 4G bits 


DIV and MOD 


There are two special arithmetic operators which give integer results. 
These are called DIV and MOD. 


DIV is an integer division function. It gives the whole number part of a 
division, for example: 9 DIV 2 is 4, 19.5 DIV 3 is 3. 


When decimal numbers are used, such as in the second example above, 
the computer truncates the number (meaning that it ignores the decimal 
part) before it carries out the division: 8.1 DIV 2.9 is 4. 


MOO stands for modulo, and is used to give the remainder after an 
integer division. For example: 9 MOD 2 is 1, 17 MOD 7 is 3. 
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Once again, decimal numbers are truncated before the division takes 
place. For example: 16.1 MOD 3.8 is 1. 


The TIME integer variable 


There is also a special integer variable, resident in the computer, which is 
called TIME. TIME is an elapsed-time clock: it ticks away in hundredths 
of a second. Every 1/199 of a second its value increases by 1, and it is 
used for timing programs. 


10 TH=TIME 
20 PRINT TIME -T% 


will print the time taken to execute one line of program, in hundredths of 
a second, 


TIME may be assigned a starting value, or it can be zeroed, just as any 
other variable: 


TIME=0 


TIME runs continuously for as long as the computer remains switched 
on. You will understand better how to use it when you look at some of the 
programs later in the book. 


String variables 


You have seen that a variable is a name which can be assigned a value 
either directly or by an assignment statement. The computer will store 
this value in its memory as a binary number — a series of zeros and ones. 
Characters are also stored in the computer as binary numbers, and each 
character has a code. This code is called ASCII, standing for ‘American 
Standard Code for Information Interchange’. If you look in Appendix F, 
you will see a table of ASCII codes showing all the letters, symbols, and 
numbers each with their corresponding ASCII code number. 


When you use the PRINT instruction to put a message on the screen, as 
for example: 


PRINT "ASCII" 


5@ Variables and expressions 


the quotation marks each side of the message tell the computer that what 
is in between them is a string of characters and not a variable. So each of 
the characters in the message ‘ASCII is stored as a binary number, 
corresponding to 65, 83, 67, 73, 73 in decimal, as you can see from the 
ASCII chart in Appendix F. 


There are special variables, called string variables, which hold charact- 
ers as opposed to numbers. String variables are signified by a $ sign after 
the variable name. So we can say: 


AS=""ACORN" 
fishS = "Two COD" 
Birthday$S = "Monday 23rd August" 


It is very important for you to understand how this last assignment is 
stored. Notice that the string contains a number, 23. Because of the 
quotation marks this number is not stored as 23 in binary, but as the 
ASCTI code for 2 followed by the ASCII code for 3. This knowledge is 
very useful when you come to manipulate strings using their code values. 


For example: 


PRINT "23" 
and 
PRINT 23 


both have the same effect. 
But 


PRINT "23%6" 
and 


PRINT 23%*6 


show the different ways in which numbers and strings are stored. As you 
can see from the ASCII table in Appendix F, every number has its own 
ASCII code. 


You can use the computer to find out the ASCII code of a character. 
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PRINT ASC "“Q" 


will give the ASCII value of Q which is 81. 


The opposite function is given by 
PRINT CHRS 81 


which converts the ASCII code 81 into its corresponding character which 
is Q. 


Even a space has an ASCII code. 
PRINT ASC " " 

gives 32. 

And nothing at all (an empty string): 
PRINT ASC "" 


gives —1. 


This is not an ASCII value, but is conveniently different from all the 
others as to be easily distinguishable. 


The instruction 

PRINT CHRS 81 

has an equivalent which is easier to type: 
vbU 81 


is identical, so VDU 81 gives the letter Q. 


Commands operating on strings 


LEN 

String variables may be up to 255 characters long, and there is an 
instruction LEN, which gives the length of a string-the number of 
characters it contains. 
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PRINT LEN “ABCDEF” 


will print 6 on the screen. 
Similarly, 


AS="S 0 S" 
PRINT LEN AS 


will print 5 (because a space is a character). 


Linking strings 

Two or more strings may be linked together by using the ‘+’ operator, 
which apart from its arithmetic use, can simply link strings. The following 
program is an example of this. 


10 AS = "I'M" 

20 BS = "LEARNING" 
30 c$ = "BASIC" 

40 DS = A$ + BS + CH 
5@ PRINT D$ 

>RUN 


I'MLEARNINGBASIC 


LEFT$, RIGHTS, MID$ 
Not surprisingly, if the computer can link strings it can also disassemble 
a string to make smaller ones, using LEFT$, RIGHTS, and MIDS. 


10 AS = "INEQUITABLE" 
20 BS = LEFTSCA$,2) 
B@ C$ = RIGHTSC(AS,5) 
4@ DOS = MID$(A$,3,4) 


58 PRINT BS 
6@ PRINT C$ 
7@ PRINT DS 
>RUN 
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Notice how the three functions LEFTS$, RIGHTS, and MIDS are used: 


LEFTS (AS$,2) copies the first two characters of string A$. In the program, 
these two characters are copied into B$. 


RIGHTS (AS,5) copies the last five characters of string A$. 


MIDS (AS,3,4) copies four characters from string A$, beginning at the 
third character from the left. 


VAL, EVAL, STR$ 
There are three more string operating functions which convert to or from 
numbers: VAL, EVAL, and STRS. 


10 Xx$ = "57/7 * SIN.6" 
20 PRINT VAL X$ 
3@ PRINT EVAL X$ 


When you run this program, VAL X$ gives the number with which the 
string X$ begins, in this case 57. If the string does not begin with a 
number then VAL returns the value ¢. 


EVAL X$ evaluates the string as if it were a numeric function, giving in 
this case 4.597893. EVAL will also evaluate variables in strings, provided 
these variables have been assigned earlier in the program. 


Sometimes you need to turn a number into a string, and this is done by 
using the instruction STRS. 


10 A=45 ; B=30 
20 AS = STRSCA) 
30 BS = STRS(B) 
4@ PRINT A + B 
5@ PRINT A$ + BS 


INSTR 

Another useful string function is INSTR (standing for IN STRING) which 
will compare two strings and tell you whether one of these strings is 
contained within the other, and at what position. 


For example 


10 AS 
20 BS 


"INEQUITABLE" 


e 
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30 Z = INSTRC(AS,B$,2) 
40 PRINT Z 


This program shows that INSTR returns the position at which B$ is the 
same as A$. We can start the INSTR comparison at any point along the 
string. 


This program starts the comparison at the second character of string A$, 
and therefore indicates the second ‘I’ at position 6. If INSTR is used and 
there is no similarity between the strings, a 9 is given. 


STRING$ 

The last string function, STRINGS, is used when you want to make a long 
string which consists of repeated units. For example, if you wish to use a 
string to print a border made up from *-*—*_*- etc then it is easier to use 
the STRINGS function than to type all the characters. 


10 AS = Mx" 

20 BS =STRINGS(20,A$) 
30 PRINT BS 

>RUN 


ee ee ee ee ee ee ee ee ee 
The string B$ is made up from 29 copies of the string A$. 


Comparison table of variables 


Finally, here is the complete comparison table for integer, real, and string 
variables: 


Integer Real String 
Example 819 1.141 “WORDS” 
Typical variables A% A A$ 
Maximum size 2,147,483,647 1.7 X 19°8 255 characters 
Accuracy absolute 9 sig figs _— 
Stored in 32 bits 49 bits ASCT values 


12 Operator precedence 


When a mathematical or logical expression is being evaluated, all the 
operators (+,*,DIV etc) are given a priority of from 1 to 7. Priority 1 
operators are those acted upon first, and priority 7 last. 


Here is the complete list: 


Priority 
1 


AND 
OR 


Operator 


Unary minus 

Unary plus 

Logical NOT 
Functions 

Brackets 

Indirection operators 


Raise to the power 


Multiplication 
Division 

Integer division 
Integer remainder 


Addition 
Subtraction 


Equal to 

Not equal to 

Less than 

Greater than 

Less than or equal to 
Greater than or equal to 


Logical and bitwise AND 


Logical and bitwise OR 
Logical and bitwise Exclusive OR 


Operators with the same priority are executed left to right, as they 
appear in the expression. For example, 22 MOD 3/7 is evaluated as (22 
MOD 3)/7. All priorities may be overridden by using brackets. 


13 Arrays 


Arrays are groups of variables. An array variable has a name, just as any 
other, and it also has one or more subscripts. A subscript is a number, 
and an array variable is numbered according to its position in the array. 
For example, A(§) is the first variable in the array named A, and A(1) is the 
second variable. The computer must be told how many variables you 
wish to use in the array, and this is done by using a DIM instruction: 


DIM AC9) 


allocates space in the computer’s memory for ten variables, each called 
A, but each having a different subscript. 


These variables are A(@), A(1), A(2) . . . A(8), A(9). Each one of these 


variables may be individually assigned, just like any ordinary variable. 


String arrays may also be used. 
DIM A$(9) 


allocates space for ten string variables — each of up to 255 characters. 


The examples shown above are one dimensional arrays — you can think of 
them as a line containing a number of variables, subscripted from @ to 9 
in sequence. Two dimensional arrays can be thought of as the printing on 
the TV screen. Each character printed on the screen is at a particular 
position from the left, and a particular position from the top. 


DIM AC2,2) 


allocates space for nine variables, each called A, and each having two 
subscripts: 


A(O,8) AC1,8) AC2,8) 
ACO,1) AC1,1) AC2,1) 
ACO,2) AC1,2) AC2,2) 


Arrays may have as many dimensions as you like, may contain as many 
variables as you like, and may be either real, integer, or string. 
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One of the invaluable features of an array variable is that its subscript 
need not be specified as a number; you can use a variable: 


1@ DIM AC9) 
20 X = 6 
3@ ACX) = 27 


This program will place 27 in A(6). You can even use an array variable as 
the subscript: 


10 DIM AC29) 

20 xX = 6 

30 ACX) = 27 

40 ACACX)) = 564.3 


Any arithmetic expression may be used as a subscript, and if the subscript 
works out to anumber with a decimal point, then the number is truncated 
to its integer value, ie just the part before the decimal point. 


Remember, when using arrays, that if you DIM using three subscripts, 
each variable must be called with three subscripts. 


1@ DIM NAMES$(2,2,2) 
20 NAMES(@) = "FRED" 


will not work. You would have to use, say, 
20 NAMES(@,0,0) = "FRED" 


Be careful when using arrays — they consume vast amounts of memory, 
and if you try to use too many variables the computer will say, 


DIM Space 


meaning that there isn’t enough room in its memory. 


14 READ...DATA... 
RESTORE 


These instructions provide you with a way of giving data to a program 
before it is run. This means that the data can be saved as part of the 
program (see chapter 9). The variables are placed after READ, and eachis 
loaded in turn from the information placed after DATA. 


16 FOR I = 1T0 4 

20 READ Age%,Dog$ 

3@ PRINT “Name: “3Dog$;" Age: ";Age% 
40 NEXT I 

5@ DATA 9, BONZO,3,ROVER 
60 DATA 7 

7@ DATA SPOT,12,HENRY 
>RUN 

Name: BONZO Age: 9 

Name: ROVER Age: 3 

Name: SPOT Age: 7 

Name: HENRY Age: 12 


You can see that it doesn’t matter how many DATA instructions are used 
provided the types of data match the variable. 


RESTORE is used to set the data-pointer to the start of the DATA, in this 
case line 5%. It can also be used to set the data-pointer to any line 
number: 


1G INPUT "Which dog (1 to 4)", A 
28 RESTORE (A+4)*10 

3@ READ Agex, Dogs 

4@ PRINT “NAME: ";Dog$;" Age: ";Age% 
5@ DATA 9,B0NZ0O 

6@ DATA 3, ROVER 

70 DATA 7, SPOT 

80 DATA 12, HENRY 

>RUN 

Which dog (1 to 4)22 

NAME: ROVER Age: 3 


15 PRINT formatting 
and INPUT 


PRINT formatting 


You are already familiar with the PRINT statement, and how it is used to 
put characters on the screen. In this chapter you will find out how to use 
PRINT to position the output on the screen. 


Press EuizZ,U@ and then try the following program. 


10 xX = 6 
20 PRINT X;X;X 
3G PRINT X,X,X 
40 PRINT X'X'X 
>RUN 
666 
6 6 6 


6 
6 
6 


From this you can see that 


(i) Items in the PRINT instruction separated by semicolons are printed 
one after the other, with no spaces. 


(ii) Items separated by commas are tabulated into columns. These 
columns are ten characters wide and are called fields. 


(iii) Items separated by apostrophes are printed on a new line. 


Now try the following program: 


10 AS = "JU" 

20 PRINT A4;A$;A4$; AS; AS 
3@ PRINT AS,A$,AS 

40 PRINT AS'AS'AS 

>RUN 
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JdJ 
J J J 


J 
J 
J 
This is the same program as before, but using a string variable. Notice 


that the character is not printed in the same place as the number. Here is 
another program to demonstrate this: 


10 X = 6 
20 AS = "UN" 
3@ PRINT X, XX,X'AS,A$,AS 
>RUN 

6 6 6 
J J J 


VA 
Field No 1 Field No 2 Field No 3 


Each field of ten characters width is shown above. As you can see, 
numbers are printed out to the right of each field, characters to the left. 
This is done so that numbers line up in the units column, or the least 
significant decimal. 


The width of these fields can be altered, as can the number of decimal 
places to which real numbers are printed. The Electron normally gives 
each field a width of ten characters. The number of fields across the 
screen depends upon which mode you are using. There are three 
different character sizes that are available, and these give either eight 
fields, four fields, or two fields, each of width ten. 


8@ character modes 49 character modes 2¢@ character modes 
(MODES @ and 3) {MODES 1,4,6) (MODES 2 and 5) 
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If you now type 
PRINT 6,9,7/3,57 


you will see that the 9 and the decimal equivalent of 7/3 have run into 
each other: 


6 92.33333333 57 


To prevent this happening the field width and/or the number of decimal 
places can be altered using the integer variable. @ %. 


If you type 

a% = &204D0A 

and then 

PRINT 6,9,7/3,57 

you can see the effect of reducing the number of decimal places to 4. 


6.0000 9.0080 2.3333 57.0000 


The assignment of the variable @% is made up of a number of parts: 


& indicates that a hexadecimal number follows. Hexadecimal numbers 
are explained in chapter 6. 


After the & sign, the first number of @ % indicates the format of the print 
field. 2 means that the computer will print a fixed number of decimal 
places. 


The next two figures indicate the number of decimal places which are 
required, in this case 4. 


The final two figures give the field width, in this case GA which is 19 in 
decimal. 


So, 
a% = &28105 


will give each number printed to one decimal place, with a field width of 
five. 
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Some more points: 
(i) The format, the first figure after the & symbol, can take three values: 


@ is the normal configuration — the format which the computer uses when 
it is first switched on. 


1 gives numbers in exponent form, that is an integer followed by a power 
of ten. So $.606 would be printed 6E-4. (‘Six times ten to the power of 
minus four’.) 


2, as just shown, gives numbers to a fixed number of decimal places. 


(ii} When the computer is first switched on, @% = 9H9GA. This gives 
nine significant figures and a field width of ten. 


(iii) The computer will not print more than ten significant figures. The 
ten significant figure format is obtained by setting @% to, for example, 
&OPAGC. This will give ten significant figures and a field width of 12. 
Alternatively, typing @% = 12 will give the same result, because the 
number of significant figures is assumed to be ten if it is not specified. 


You can make the print instruction convert decimal numbers or variables 
into hexadecimal by using the ~~ character. 


PRINT “10 
will give A (decimal 19 in hex). 
PRINT “LENGTH 


will print out the contents of the variable LENGTH in hex. 


The position on the screen at which PRINT prints is controllable by the 
TAB instruction. 


PRINT TABC16); "J" 


will print the character J 16 spaces across the screen. 


As is usual with functions, the number in the brackets may be a variable, 
or any arithmetic expression. 
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TAB can also be used with two parameters (numbers in the brackets). If 
you imagine the screen to have coordinates, the number of columns 
going across the top, and the number of rows down the side, then 


PRINT TAB(16,22); "J" 


will print the character J 16 spaces across the screen and 22 spaces 
down. 


These text coordinates vary depending upon which mode you are using. 


9,0 19,6 


MODES 


2and 5 


9,31 
¢,6 ——_-_—_—_——+ 39,9 9.9 ————————— 79,8 
MODES MODE 
land 4 % 
4,31 8,31 
9,4 ———_—_—_—— 39, 0,9 ———__———+ 79.8 
MODE MODE 
6 3 


G$,24 6,25 
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TAB instructions have the effect of moving the cursor around the screen. 
PRINT TAB(@,@) 


will always move the cursor to the top left of the screen in any mode. 


If at any time you wish to turn the cursor off, you can do so by typing 
VOU 23,1,0;0;0;0; 

Tt will still exist of course, but it will not be printed on the screen. 
VDU 23,1,1;0;0;0; 


will return the cursor to the screen once more. 


INPUT 


So far, the only form of input that you’ve made to the computer is the 
typing of commands and programs. Often you will need to give the 
computer information while the program is running. 


16 PRINT "GIVE ME A NUMBER AND I'LL DOUBLE 
IT" 

20 INPUT X 

3@ PRINT “DOUBLE ";X;" IS "3X*2 

>RUN 

GIVE ME A NUMBER AND I'LL DOUBLE IT 

216 

DOUBLE 16 IS 32 


When you run this program, line 29 prints a question mark on the screen. 
This question mark invites you to type in some data. When you press 
the number that you typed is put in X. If you don’t type a 
number, or you type letters or symbols instead, X becomes zero. 


INPUT may also be used with string and integer variables. 
10 PRINT “WHAT IS YOUR NAME" 


2@ INPUT A$ 
3@ PRINT “NICE TO MEET YOU, ";A$ 
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>RUN 

WHAT IS YOUR NAME 
?D0BBIN 

NICE TO MEET YOU, DOBBIN 


Lines 14 of the above two programs have been used to print a message 
on the screen. This message can be incorporated into the INPUT 
instruction. 


1@ INPUT “WHAT IS YOUR NAME ",A$ 

20 PRINT “ARE YOU SURE ABOUT THAT, “ A$;"2" 
>RUN 

WHAT IS YOUR NAME 7EINSTEIN 

ARE YOU SURE ABOUT THAT, EINSTEIN? 


Notice the commain line 19 of this program. It tells the computer to print 
a question mark when it wants input from the keyboard. If you leave out 
the comma, the question mark will not be printed. A semi-colon may be 
used, and has exactly the same effect as the comma. 


When the program is running, the INPUT instruction requires you to 
press RETURN when_you wish to send what you have typed to the 
computer, Up until ESA preset you_can delete all or part of 
what you have typed using U or the key. 


When you are inputting a string, the computer will ignore any leading 
spaces, and anything after a comma, unless you put the whole string 
inside quotation marks. 


10 INPUT A$ 
20 PRINT AS 


>RUN 

2BUS, CAR 
BUS 

>RUN 

2"BUS, CAR" 


BUS, CAR 
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Alternatively, you can use INPUT LINE, and inverted commas will not be 
needed. 


1@ INPUT LINE A$ 
20 PRINT A$ 
>RUN 

7FISH, AND CHIPS 
FISH, AND CHIPS 


Several inputs can be requested at one time. 


1@ INPUT A,B,C$ 
20 PRINT A,B,C$ 
>RUN 
220.3, -16, INCHES 
20.3 -16INCHES 


This time you must use commas to separate each piece of data which you 
type. 


Another way of entering data is to use GETS. This reads the key which you 
press. © 


1@ PRINT "PRESS A KEY" 
20 AS = GETS 
3@ PRINT “THE KEY YOU PRESSED WAS "“; A$ 


The program waits at line 24 until you press a key. As soon as you do, the 
character which that key represents is placed in AS. 


A similar instruction to GETS is INKEYS. 


1@ PRINT "PRESS A KEY IN THE NEXT SECOND" 
20 AS = INKEY$100 

3@ IF AS = "" THEN PRINT "YOU WERE TOO SLOW" 
ELSE PRINT "THE KEY YOU PRESSED WAS ";A$ 


Using this program, line 2 waits one second for you to press a key. If no 
key is pressed in that time then the program moves on. The INKEYS 
instruction has a number after it which is hundredths of a second. The 
larger the number, the longer the computer will wait for you to press a 
key. If you don’t press a key in time, INKEY$ will give the value —1. 
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Line 3@ of this program shows an IF statement. IF statements are 
discussed in detail in chapter 16. 


There are two more input instructions, GET and INKEY. These are exactly 
the same in operation as GET$ and INKEYS, but their effect is to give the 
ASCII code of the key which you press. GET and INKEY give a number, 
and must therefore be assigned to number variables. 


16 Xx 
20 Y 


GET 
INKEY 500 


If you use either INKEY or INKEY$ with its time delay set to @, the 
computer will not wait for you to press a key, but will merely glance at the 
keyboard to see if any key has already been pressed. This is useful when 
you come to write games, as the rest of the program is not held up waiting 
for a key to be pressed. 


It is important to know that INKEY, INKEYS, GET and GETS will notice not 
just the key you happen to be pressing at the time, but also any key you 
have pressed since the last time the computer asked for input. Every 
time you press a key it is placed in the keyboard buffer (a buffer is a short- 
term memory), and it is this buffer which GET and the others actually look 
at. 


However, if you want to ignore any keys previously pressed, and just look 
at the keyboard directly, there’s a version of INKEY to do this. This is 
done by giving INKEY a negative number, each key having a corre- 
sponding value which you can use. For example, INKEY(—79) only 
operates when the J key is pressed. This use of INKEY is discussed in 
more detail in chapter 25, including a table of all the key codes. 


16 Conditional and loop 
instructions 


Programs and parts of programs can be made to execute over and over 
again either continuously, or a specified number of times. The in- 


structions you put in your program to make this happen are called LOOP 
instructions. 


The FOR... NEXT loop 


The most common type of loop is FOR... NEXT, which uses a variable to 
count the number of repetitions required. 


10 FOR N = 1 TO 6 


20 PRINT N 

30 NEXT N 

>RUN 
1 
2 
3 
4 
5 
6 


In this program, N is printed at each pass through the loop. N is called the 
control variable. 


You can start the control variable at any number you choose, and you 
may alter the amount by which it changes on each pass, the step size. 


10 FOR N = 7 TO 11 STEP 1.6 
20 FOR J = 20 TO 10 STEP -5 
3@ PRINT N,J 
40 NEXT J 
5@ NEXT N 
>RUN 
7 20 
7 15 
7 10 
8.6 20 
8.6 15 
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8.6 18 
10.2 20 
10.2 15 
10.2 10 


This program shows that you can use decimal step sizes, or negative step 
sizes. You may start the control variable at any value; and you may use 
FOR... NEXT loops within each other. This is called nesting, and you can 
nest as many loops as you wish. 


Type 
LISTO2 
followed by G{alUGh, and then LIST the program again. 


10 FOR N = 7 TO 11 STEP 1.6 
20 FOR J = 2@ TO 10 STEP ~-5 


30 PRINT N,J 
40 NEXT J 
56 NEXT N 


Each loop is shown indented from the previous one. 
LISTO is a list option instruction and can take any number from 9 to 7. 


LISTOP is the normal setting — it lists exactly what the computer has 
stored in memory. 


LISTO1 lists the program with an extra space after each line number. 
LISTO2 lists the program with indents on FOR ... NEXT loops. 
LISTO4 lists the program with indents on REPEAT . .. UNTIL loops. 


These effects may be obtained in any combination by adding the 
numbers together, so LISTO3 would give extra spaces after line numbers 
and indented FOR ... NEXT loops. 


Here are some further points on the use of FOR ... NEXT loops. 


(i) You do not need to specify the control variable to which NEXT refers. 
The following program will work exactly the same as the one above. 


7@ Conditional and loop instructions 


1@ FOR N = 7 TO 11 STEP 1.6 
20 FOR J = 20 TO 1@ STEP -5 
3@ PRINT N,J 

40 NEXT 

5@ NEXT 


The computer assumes that NEXT applies to the loop it is in at the 
present moment. 


If you do put the variable names after NEXT, but get them mixed up, then 
this is what happens. 


16 FOR N = 7 TO 11 STEP 1.6 
20 FOR J = 20 TO 1@ STEP -5 
30 PRINT N,J 
40 NEXT N 
5@ NEXT J 
>RUN 
7 20 
8.6 20 
10.2 20 


No FOR at line 5@ 


The computer starts to execute the N loop before the J loop, and when it 
reaches line 59 it cannot find the FOR to go with NEXT J. Loops must be 
nested one within another; they must not cross. 


(ii) The number of FORs, and the number of NEXTs must be the same. 


The following program does not give an error, but it is left hanging in mid- 
air. 


10 FOR N = 7 TO 11 STEP 1.6 
20 FOR J = 20 TO 10 STEP -5 
3@ PRINT N,J 
40 NEXT 
>RUN 

7 20 

7 15 

7 19 
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If you do this, you will run into trouble. 


(iii) You must never jump out of a FOR. . . NEXT loop using GOTO. As in 
(ii) above this will often not result in an error, but the program will be 
impossible to follow. 


(iv) The stop condition for a loop is that, for a positive step size, the 
control variable is greater than the terminating value; for a negative step 
size, the control variable is less than the terminating value. However, all 
loops will be executed at least once. 


1@ FOR NUMBER = 6 TO @ 
2@ PRINT NUMBER 
3@ NEXT 
>RUN 
6 


When the loop has been completed, the control variable moves on an 
extra step, so the above program will end up with NUMBER equal to 7. 
Here is a program to show this: 


10 FOR Size = 100 TO 103 STEP 1.5 


2@ PRINT "INSIDE LOOP, Size = ";Size 
30 NEXT 

4G PRINT “OUTSIDE LOOP, Size = ";Size 
>RUN 

INSIDE LOOP, Size = 100 

INSIDE LOOP, Size = 101.5 

INSIDE LOOP, Size = 103 


OUTSIDE LOOP, Size = 104.5 


(v) FOR ... NEXT loops are used when you wish to go around a loop a 
fixed number of times. There may be as many lines as you like between 
the FOR and its corresponding NEXT, and control variables need not be 
directly assigned with numbers. They can be assigned with any arith- 
metic expression, containing variables or other functions. 


10 MODE 5 

20 FOR angle = @ TO 2*PI STEP .1 

30 PLOT 69,649 + 44@*SINCangle), 572 + 400* 
cosCangle) 

40 NEXT 


72 Conditional and loop instructions 


The REPEAT ... UNTIL loop 


Another very useful loop is REPEAT. . . UNTIL, which waits until a condition 
is fulfilled before coming out of the loop. 


10 INPUT'"This program turns decimals into 
fractions"'"Give me a decimal: “decimal 

2@ numerator% = 1: denominator% = 1 

30 PRINT "Program running" 

4@ REPEAT 

5@ fraction = numerator%/denominator% 

60 IF fraction>decimal THEN denominator% = 
denominator%+1 

70 IF fraction<decimal THEN numerator% = nu 
merator%t1 

8@ UNTIL fraction = decimal 

9@ PRINT;decimal;" is equal to "s;numerato 
r4a;"/"denominator%’' "Program end" 


This program asks you to input a decimal. It then prints out the fractional 
equivalent. (Don’t input too complicated a decimal or the program will 
run for hours.) Lines 59 and 6 are repeated until the condition at line 89 
is fulfilled. In this example, the condition is that fraction = decimal. 


Line 89 is called a conditional statement, and the result of a conditional 
statement may either be TRUE or FALSE. In the example shown above, the 
statement becomes TRUE when fraction is equal to decimal, so the program 
loop is repeated only whilst the conditional statement is FALSE. Of course, 
the computer doesn’t understand TRUE and FALSE, so it assigns numeric 
values to these conditions: 


§ for FALSE, —1 for TRUE. 


There are a number of logical operators which can be used in conditional 
statements: 


A=B True when A is equal to B 

A<B True when A is less than B 

A>B True when A is greater than B 

A<=B True when A is less than or equal to B 
A>=B _ True when A is greater than or equal to B 
A<>B_ True when A is not equal to B 

NOTA True when A is false 
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TRUE True always 

FALSE False always 

A AND B True if both A and B are true 

AORB True if either A or B is true, or if both are true 
AEORB True if either A or B is true, but false if both are true 


There is more about logic operations in the next section on the IF statement. 


REPEAT ... UNTIL is easily followed and understood by other people who 
read your programs, and should be used in preference to GOTO. 


IF... THEN ... ELSE 


The IF statement enables the computer to make a choice about 
something. 


10 REPEAT 


20 AS = GETS 


30 IF AS = "Y" THEN PRINT "YES"; ELSE PRINT 
AS; 
4@ UNTIL FALSE 


This program turns the Y key into a YES-button. Line 39 contains a 
conditional statement. If the condition is true then the computer obeys 
whatever comes after THEN. If the statement is false then the computer 
carries out whatever comes after ELSE. 


IF statements can carry out more than one instruction, if these instr- 
uctions are placed on the same line and are separated by colons: 


10 REPEAT 

26 AS = GETS 

30 IF A$ = "Y" THEN FOR I = 1 TO 6 : PRINT 
"YES";: NEXT ELSE PRINT A$; 

4@ UNTIL FALSE 


and now you will get six YESs when you type Y. 


These multi-statement lines are not restricted to the IF statement. Any 
line in a program may carry out more than one instruction if each is 
separated by a colon. However, it is generally better to use a procedure 
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rather than fill an IF statement full of colons. Procedures are explained in 
chapter 17. 


IF statements may ask for a complex condition, using the logical 
operators AND, OR, and EOR. 


10 REPEAT 

20 AS = GETS 

30 BS = GETS 

40 IF AS = "Y" AND BS = "Y" THEN PRINT "YES 
">; ELSE PRINT A$;BS 

5@ UNTIL FALSE 


This program will only print YES if you type two Ys in succession. 
The ELSE part of the statement is optional, and may be omitted. 


Alternatively you can extend the IF statement by chaining it: 


10 REPEAT 

20 A$ = GETS 

30 IF AS = "Y" THEN PRINT "YES" ELSE IF AS 
= "N" THEN PRINT "NO" ELSE PRINT "MAYBE" 
4@ UNTIL FALSE 


This program demonstrates the use of one IF statement after another. . . 


Using the IF statement you can now find out some more about how the 
computer deals with TRUE and FALSE. 


10 X=8>6 
20 Y=6>8 
30 PRINT X,Y 
>RUN 
-1 @ 


Because 8 is greater than 6, 8 > 6 is TRUE, so X is— 1. 6 > 8 is FALSE, so 
Y is @. 


10 REPEAT 
2@ INPUT X 
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30 IF X THEN PRINT;X; " IS TRUE" ELSE PRINT 
3X; " IS FALSE" 
4@ UNTIL @ 


This program allows you to enter numbers, and to see whether the 
computer treats them as TRUE or FALSE. You will see that only @ is 
treated as FALSE, all other values being TRUE. 


The above program can be rewritten: 


10 REPEAT 

2@ INPUT X 

3Q IF X THEN PRINT 3X; IS TRUE“ ELSE PRINT 
3X;" IS FALSE" 

4@ UNTIL FALSE 


which has exactly the same effect. 


Another important use of IF is with strings and string variables. For 
example, you might find this in the middle of a program 


1G@ REM The answer should be 568 

110 INPUT "SO WHAT'S THE ANSWER THEN?"'X 
120 IF X = 56@ THEN AS = "YES" ELSE AS = "N 
o" 

13@ IF AS = "YES" THEN PRINT AS;" WELL DONE 
" ELSE PRINT A$;" TRY AGAIN" 


This will test to see what string A$ contains, and will print one of two 
messages accordingly. 


Less than and greater than can also be used: 


10 AS = "HELLO" 
2@ IF AS < "GOODBYE" THEN... 


This will be true, because the IF statement compares the ASCII values of 
the first character in each string. If the first two characters are the same, 
then the next two characters are compared, and so on. So ‘MELON’ is 
less than ‘MELTED’. This is very useful for putting strings into 
alphabetical order, but it does not work if the strings are a mixture of 
upper and lower case letters. 
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The following operators may be used with strings: 


= the same as 
<> not equal to 
less than 
> — greater than 
<= _ less than, or equal to 
>= greater than, or equal to 


17 Procedures 


Using procedures allows you to split up virtually any program you are going 
to write into a main program, followed by a number of ‘mini-programs’ 
(procedures), which can be called from the main program by a single 
statement. 


A procedure is simply a collection of numbered BASIC statements which 
you write in order to perform a particular task. This collection of 
statements looks just like part of an ordinary program, but the 
differences are that the first line contains the name of the procedure 
(which is decided by you), and the last line contains a BASIC word to 
signify the end of the procedure. When the computer encounters the end, it 
then returns to the main program and carries on. 


The rules for using procedures are very simple. A procedure is called 
from the main program by the BASIC word PROC followed immediately 
by the procedure’s name. The name can be anything you like, but there 
must be no spaces in it. For example: 


PROCnewline 
PROCwait_a_second 
PROCDRAWPICTURE 


Note the underline character in the second example which helps ‘space 
out’ the name. 


A procedure name should reflect the function of the procedure to which 
it applies. If you merely name your procedures PROCA, PROCB, PROCC, 
for example, then no one will understand what they do without having to 
work through each one. So if you have a procedure which converts feet 
into metres, then call it PROCfeet__to__metres. It is best to use lower 
case names for procedures so that they distinguish themselves from the 


PROC. 


To define a procedure, you simply type a line number, followed by DEF, 
followed by the procedure name. It is a good idea to start defining your 
procedures at a fairly high line number, say 1909. 
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10@@ DEF PROCwait_a_second 
1100 NOW = TIME 

120@ REPEAT UNTIL TIME-NOW>=100 
1308 ENDPROC 


This procedure will do as its name suggests. 
ALL PROCEDURE DEFINITIONS MUST END WITH ENDPROC. 


When you want the computer to carry out the instructions in the 
procedure, you have to call it by name: 


70 PROCwait_a_second 


or 


120 IF INKEY$1@ = “W" THEN PROCwait_a_secon 
d 


You may have as many procedures in your program as you like, and 
usually the more the better. 


THERE MUST ALWAYS BE AN END INSTRUCTION BETWEEN 
THE END OF THE MAIN PROGRAM AND THE PROCEDURE 
DEFINITION. 


For example 


1@ REM Sample program 

20 FOR X = @ TO 29 

3@ PRINT TAB(10,10);"COUNTING..."X" Seconds 

40 PROCwWait_a_second 

5@ NEXT 

6@ PRINT TAB(1G,10);"Half a minute up! 
iy 

7@ END 

1@0@ DEF PROCwait_a_second 

11@0 NOW = TIME 

120@ REPEAT UNTIL TIME-NOW>=100 

13@0@ ENDPROC 


There is a program on the Introductory Cassette to illustrate the use of 
procedures, and also give you some fun. Load this program which is 
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called ‘BUGZAP’ into your Electron first. See chapter 4 for instructions 
on how to load a program. 


When you LIST along program obviously you cannot see all of the lines on 
the screen at the same time. Using LIST with specified line numbers is 
one way around this, but another is to put the computer into paged mode. 
This is done by pressing N. (No is required.) If you now 
use LIST, the program will be listed until the screen is full. When you want 
to look at the next part just press and another screen full will 
appear. If you want to change a line number, you must press ‘ 
To get the computer out of paged mode, type Oo. 


Look at just one procedure from this program: 


52@DEF PROCinfo 

530CLS 

S4QPRINT''''' "Welcome to the game of Bugzap 
pine 

SS@PRINT"The object of the game is to use y 

our" 

S6G@PRINT"Laser gun to zap the descending bu 
uw 

S7GPRINT"before it lands or bombs you.” 
S8@PRINT'"Your score increases every time y 

ou" 

SOGPRINT"zap the bug, with more points bein 
ow 

6GQOPRINT"given the lower the bug is; it wil 
tl be" 

61GPRINT"displayed when you are killed." 
62Q@PRINT'"The controls are:"' 


630PRINT"Z = left" 
64BPRINT"X = right" 
65GPRINT"SPACE = fire” 


66GPRINT'' "Pressing the ESCAPE key wilt tak 
e you” 

67GPRINT"to the end of the program." 
68OPRINTTAB(5,31)"Press SPACE to start the 
game"; 

69GREPEAT: UNTIL GET$=" " 

7GQENDPROC 
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This procedure is called from line 9¢ of the main program. 
9OPROC info 


Line 529 is the start of the definition. 
Line 539 clears the screen. 


Lines 549 to 689 print the introduction and instructions about the 
BUGZAP game which you see when you run the program. 


Line 699 is an example of putting two separate BASIC statements after 
one line number by separating them witha colon. The purpose of line 69 
is to wait until the space bar is pressed: GET$ = "", When the space bar is 
pressed, line 709 is executed. 


Line 709 signifies the end of the procedure, and the computer goes back 
to the main program to the line immediately after the procedure call 
(S9PROCinfo), which is line 169. 


Here is one of the procedures from the ‘MARSLANDER’ program — also 
on the Introductory Cassette. 


86GDEF PROCrocket (direction%) 

87@REM If there is any fuel then fire rocke 
t-motor and make sound 

88O0IF fuel% THEN fuel%=fuel%-1 ELSE ENDPROC 
89GIF fuel%=29 THEN SOUND 1,-10,68,10 ELSE 
SOUND 0,-1,5,2 

9GGON direction% GOTO 918,920,930,940 
9IBVYZ=VY%— Sr ENDPROC 

92OVXZ=VXK410: ENDPROC 

O3OVYZ=VY%+15: ENDPROC 

S4OVX“Z=VX%-18: ENDPROC 


This procedure alters the speed of the spacecraft according to the 
direction in which it is pointing, which is given by the variable direction%. 


This procedure is called from line 259. 
25@1F INKEY(-99) THEN PROCrocket(z%) 


Z% is an integer variable which is used by the program to give the 
attitude of the spaceship. 
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When the computer reaches line 259 it tests to see if the space bar is 
pressed. If it is, the computer then places the contents of Z% into 
direction%. 


The variable Z%, and hence the parameter direction%, can be anything 
from 1 to 4, where 1 indicates the capsule pointing up, 2 to the right, 3 
down, and 4 to the left. These positions are represented by characters 
224 to 227 which are user-definable. 


Line 884 checks to see whether there is any fuel left. The variable fuel% 
will be FALSE when it is zero and the procedure will end. 


If itis TRUE one unit of fuel is deducted by decrementing its contents by 
1. Line 890 makes either a ‘beep’ (fuel is low), or a rocket motor sound 
(fuel is not low). 


SOUND is explained in chapter 22. 


Line 990 uses ON . . . GOTO, to act according to the direction of the 
spacecraft. The parameter direction% now contains the value given to it 
by Z%. If the spacecraft is pointing up, direction% is 1 and execution 
continues at line 919. 


Line 919 decreases the vertical speed of the capsule. (VY % is the vertical 
speed measured positive in a downward direction; VX% is the horizontal 
speed measured positive in a left-to-right direction.) If the capsule is 
pointing to the left line 969 passes execution to line 920 which increases 
the horizontal speed of the capsule. 


Lines 934 and 94@ increase the vertical speed and decrease the 
horizontal speed respectively. After any one of these lines (916 to 949) 
has been executed, the procedure ends. 


Using parameters in procedures 


Using the above example, Z% and direction% are termed parameters. 
The idea behind using parameters is that they are more efficient than 
global variables. A global variable is one which is accessible throughout 
the whole program, and may be altered or re-assigned at any line number. 


Once a global variable such as Z% has been passed to the procedure asa 
parameter, the variable which takes its place, direction%, is only known 
to that procedure. Outside PROCspaceship you can ask the computer to 


252 PRINT direction% 
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and it will give an error because the variable direction% does not exist in 
that part of the program. Global variables which are passed to the 
procedure are called the actual parameters, and the variables within the 
procedure are called formal parameters. 


A procedure may be defined with only one parameter, or it may be 
defined with lots of parameters. But a procedure must always be called 
with the correct number of parameters. PROCspaceship, starting at line 
759, has three parameters. 


So you could not call PROCspaceship(X%,Y). 


Parameters may be integer, real, or string. If a string variable is used as a 
formal parameter then it must have either a string or a string variable 
passed to it. Real and integer parameters may be passed to one another 
and interchanged freely, but remember that the fraction part of a real 
variable will be lost when assigned to an integer variable. 


The idea of a variable being defined only within a certain section of a 
program is commonplace in a lot of computer languages, but unusual in 
BASIC. Electron BASIC allows you to declare any variable as local toa 
procedure or function (functions are discussed in chapter 19). A local 
variable may even have the same name as a global variable in the same 
program, but will lead a separate existence. 


For example: 


10 FOR I = 1 TO 3 
20 PROClocal (I) 
3@ PRINT "OUT OF PROCEDURE I = "3I 


4@ NEXT I 
5@ END 


6@ DEF PROCLocal (J) 

70 LOCAL I 

8G I= J 

90 I = I1*10 

1@@ PRINT "IN PROCEDURE I = "3I 
110 ENDPROC 

>RUN 

IN PROCEDURE I = 16 
OUT OF PROCEDURE I = 1 
IN PROCEDURE I = 20 
OUT OF PROCEDURE I = 2 
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IN PROCEDURE I = 3@ 
OUT OF PROCEDURE I = 3 


Notice line 5@ which says END. Because procedures are usually defined 
at the end of a program, you sometimes need to stop the execution after 
all the calls have been made. The program will terminate when the 
computer reaches the instruction END. 


There is still another way to use procedures, and that is recursively. A 
recursive procedure is one which calls itself from within its own 
definition. 


1@ answer = 1 

20 INPUT X 

3@ PROCfactorial (Xx) 

40 PRINT answer 

5@ END 

6@ DEF PROCfactorial (N) 

70 answer = answer*N 

80 IF N > 1 THEN PROCfactorial (N-1) 
90 ENDPROC 


This is a recursive procedure to find the factorial of a number. Check 
through the logic of it in your head to see that it works. Recursive 
procedures are very useful in certain circumstances, but they consume 
memory very quickly. 


18 GOTO and GOSUB 


There are four more instructions in Electron BASIC which can be used 
to tell the computer to continue executing the program at specified 
points. 


These are: 

GOTO 

GOSUB. . . RETURN 
ON... GOTO 
ON... GOSUB 
GOTO 


The simplest of these instructions is GOTO. 


10 PRINT "SCREENFUL"” 
20 GOTO 18 


Each time the computer executes line 29 it is sent back to line 19 once 
again. This program never ends: it is a continuous loop. To stop the 
program you may press either | ESCAPE | or | BREAK fl If you press 

amessage is printed giving the line number at which execution 
ceased. 


GOTO instructions may send control of the program either forwards or 
backwards, but you must be careful not to use too many GOTO loops — 
they soon become impossible to follow, and very difficult to correct when 
a program does not function as you wish it to. It is far better to use 
procedures or REPEAT . . . UNTIL statements where possible. 


GOSUB... RETURN 


GOSUB stands for ‘Go To Subroutine’, and is really just a variation of 
GOTO. It is strongly advised that you use the more readable and more 
flexible procedure instead of GOSUB. It is used when a particular routine 
is used several times in different parts of the same program, for example 
to read a key. 
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It is most useful with IF statements. 


Here is a game which requires you to put a set of numbers in sequence. 
The GOSUB routine is called from various parts of the program, and has 
the effect of swapping the numbers around according to which key you 
press. 


1@ REM SWAP-ROUND 

20 MODE 6 

30 VDU23,1,0;0;9;0; 

4@ answer$="123456789" 

5@ number$=answer$ 

6@ INPUT TAB(8,16)"Difficulty Level",level 
70 FOR I=1 TO Level 

80 position=RND (8) +1 

9@ GOSUB 210 

100 NEXT 

110 CLS:PRINT TAB(15,10);number$ 

12@ PRINT TAB(6,16)"Press a key between 2 
and 9" 

13@ REPEAT 

14@ position=VAL GETS 

15@ IF position <2 OR position>9 THEN GOTO 
148 

160 GOSUB 2108 

17@ PRINT TAB(15,18) number$ 

180 UNTIL number$=answer$ 

19@ PRINT TAB(C6,16);SPC(9); "Well done"; SPC ( 
41); "END" 

200 END 

21@ temporary$="" 

220 FOR J=position TO 1 STEP-1 

230 temporary$=temporaryS+M1ID$(number$,J,1) 
240 NEXT 

256 number$=temporaryS+tMID$(number$,positio 
n+1) 

26@ RETURN 


As you can see, GOSUB differs from GOTO in that the program flow must 
always RETURN to the position following the subroutine call. 


Just one point about GOSUB. 
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As with FOR . .. NEXT, you should not jump out of a subroutine by using 
GOTO. If the computer keeps being told to GOSUB, without ever 
encountering a RETURN, it will soon use up its memory. 


ON ... GOTO, ON... GOSUB 


An instruction such as 


ON N GOTO 100,200,70,268 
means that the computer checks on the value of N, and then ‘jumps’ to 
the Nth line number in the list. 


So, if N = 1, the program ‘jumps’ to line 19; if N = 2 to line 200; ifN =3 
to line 70; and if N = 4 to line 269. 


ON... GOSUB works in exactly the same way. 


19 Functions 


Functions are similar to procedures, but they have only one purpose — to 
give a single result. The easiest way to understand a function is to 
describe some of the computer’s own. It has lots — the trigonometric 
functions such as SIN, TAN and COS. One of the most useful functions is 
RND, which supplies random numbers. It is usually used with a 
parameter, and gives a random integer between 1 and the value of the 
parameter. So, RND(5§) will pick a random number between and 
possibly including, 1 and 5¢. When you type X = RND(4), you know that 
the result of the function RND will be placed in X. The RND function is 
described in more detail in chapter 25. 


A function can be used with any number of parameters, both string and 
numeric. Here is a function to determine the mass of a sphere: 


100 DEF FNmass_of_sphere(radius,density) 
110 = 4/3*PI*radiusa 3*density 


Here’s another example of using a function in a program 


5 cLs 

1@ REM Discount calculator 

2@ PRINT '''''*"tThis program calculates the 
following discounts:" 

3Q@ PRINT *'"20% on £108 or less" 

4@ PRINT ''"3@% on £101 to °206" 

50 PRINT ''"5@% on anything over £200" 

6@ INPUT ‘'''' "Enter the sum ih ¥ 

70 PRINT '*'* "Final sum with discount is 

£";FN_discount (Y) 

8@ END 

10@ DEF FN_discount (SUM) 

110 IF SUM <= 100 THEN =SUM - (20*SUM/1@0) 
120 IF SUM > 1@@ AND SUM <= 200 THEN =SUM - 
(30*SUM/100) 

130 IF SUM > 2@@ THEN =SUM - (50%*SUM/10@) 


The main program starts at line 5 and ends at line 89. 
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Line 5 clears the screen, and lines 29 to 5@ print instructions on the 
screen. 


Line 69 prints a request for you to enter an amount, waits for you to do so, 
and puts the value into variable Y. 


Line 79 prints a message, and calls a function called FN__discount(Y). 
The value in Y is passed to the function's parameter, (which is the ‘actual’ 
parameter). 


Line 19% starts the definition of the function, and passes the parameter 
value to a ‘formal’ parameter called SUM. 


Line 119 contains a conditional statement. If the value of SUM is 196 or 
less, then the function returns the result given by SUM —(28*SUM/19§). 
If the value of SUM is more than 164, then the execution of line 114 stops 
before working out the SUM—(29*SUM/199), and line 129 has a go—and 


so on, 


Notice the underline character in FN__discount. This helps to make the 
function’s name more readable. 


20 Graphics 


Introduction 


This chapter deals with the VDU software — anything to do with how 
things are put on to the screen (ie the television or monitor). What 
‘modes’ are and why they are there is covered first, followed by a section 
on writing text and then details on the graphics routines. Lastly the 
palette is covered. All the individual VDU commands are listed for 
reference in the next chapter. 


Modes - what are they and why? 


The screen displays things in any one of seven modes, labelled from 
MODE § up to MODE 6. To change mode is easy — just type MODE 
followed by the mode number you want. For example 


move 2 Glagily 


changes the display to mode 2. As with all VDU commands, it can be used 
as a line ina program, and as it is a good idea to make sure your program 
starts off in the right mode, have its first line looking something like this: 


16 MODE 1 


Changing mode changes four things: 

— The number of characters you can get on the screen. 

— The number of pixels (dots) the graphics can display (and hence the 
resolution of the graphics). 

— The number of colours available at any one time on the screen. 

— The amount of memory left for programs. 
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A table giving details of these is listed below. 


No of No of No of Memory 
Mode characters graphics pixels colours used 
@ 89 X 32 649 X 256 2 26K 
1 49 X 32 320 X 256 4 20K 
2 20 X 32 166 X 256 16 29K 
3 80 X 25 {text only) 2 16K 
4 46 X 32 326 X 256 2 10K 
5 29 X 32 160 X 256 4 19K 
6 40 X 25 (text only) 2 8K 


If you don’t understand the ‘memory used’ column then don’t worry — 
basically the more detail and colours available in the mode, the more 
memory the screen uses and the less there is available for programs. The 
word ‘colour’ is used rather loosely to include the flashing colour effects. 


Try the different modes out to see the differences. Modes 3 and 6 are for 
text only — no graphics can be done in these modes (nothing will actually 
go wrong — it just won’t appear). 


Why have modes? Different programs have different requirements — 
some just need simple text output and mode 6 then leaves free as much 
memory as possible for the program. Others, such as games, need lots of 
colours and graphics detail. The modes available give a good range 
across this spectrum. 


Writing text 


The COLOUR command and text windows 

When a letter is written to the screen it has foreground and background 
colours — the colours of the ink and the paper. When the machine is 
turned on, it is always white foreground on black background. Colours (or 
more strictly logical colours — see the section on the palette) are labelled 
from § upwards. To take a definite mode for simplicity, mode 1 has four 
colours labelled from @ to 3. Try the following: 


MODE 1 Uyaguii! 


This puts you in mode 1 with white text on black background. 
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COLOUR 1 SilSQUGi) 


This sets the foreground colour to number 1 (red). Text after this 
command is red on black. 


COLOUR 130 GLaguilt 


This sets the background colour to number 2 (yellow). Text after this is 
now red on yellow, and clearing the screen with CLS makes the entire 
screen yellow. Why 139? Because to change the background instead of 
the foreground colour you must add 128 to the colour number. Thus, to 
get background colour 2 (above), add 128 to give 136. 


Changing mode resets the colours to white on black. As said before, any 
VDU commands (including COLOUR, GCOL, MOVE, DRAW etc) can be 
either typed straight (as a ‘direct command’) or used as part of a BASIC 
program. 


Addresses on the text screen 

Each letter position has its own address in the usual columns and rows 
format. The column numbering is from left to right starting from column 
@ and the rows, as for all VDUs, are labelled from the top (row 9) 
downwards. How many rows and columns there are depends on the mode 
— the drawing below shows the labelling for mode 6. 


The text screen for mode 6 


go ————_+X 39 


$ 


24 
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The cursor may be positioned to any part of the screen with the TAB(X,Y) 
command, thus the following program prints out a diagonal! line of As. 


10 MODE 1 

2@ FOR I%=@ TO 26 

3@ REM The next Line positions the text cur 
sor to the position col.=I%+5 row=1% 

4@ REM and prints the letter A at this pos 
ition 

5@ PRINT TABCI%Z+5,1%) 3 "A" 

6@ NEXT 1% 

70 END 


Text windows 


Normally, the text may appear anywhere on the screen. However a text 
window may be set, which allows the text to appear only inside the 
window. To do this, the VDU 28 command is used as follows: 


VDU 28,a,b,c,d 


where a,b is the bottom left and c,d the top right position inside the 
window (see the drawing below). 


Text 
window 


31 


Nothing outside the text window is affected by text commands, such as 
screen clearing, scrolling, cursor positioning etc. Note that the TAB(X,Y) 
measures from the position of the top left of the current window. Try the 
following program 
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10 MODE 1 

2G REM Set up a text window only 6 characte 
rs square 

30 VDU 28,5,18,19,5 

4@ REM Change the background colour to colo 
ur 1 (red) 

5@ COLOUR 129 

6@ REM Now clear the text screen to red to 
see where it is 

70 CLS 

8G REM Demonstrate scrolling 

9@ FOR 1%=1 TO 20 : PRINT I% : NEXT I% 

100 REM Lastly, show position of character 
(2,2) relative to text window 

4110 PRINT TAB(2,2);"*%" 

120 END 


Both text and graphics windows are removed by VDU 26. 


Defining your own characters 

Each character is an 8 by 8 matrix of dots (pixels). All the normal letters, 
numbers and punctuation marks are defined, but it is possible to define 
your own. 256 bytes of RAM are set aside for the definitions of 
characters whose codes are from 224 to 255. Character definitions are 
entered thus: 


VDU 23 ,CODE,L1,L2,L3,L4,L5,L6,L7,L8 


where CODE is the code of the character to be defined (it is then printed 
using either VDU CODE or PRINT CHRS(CODE);) and 


L1 is the bit pattern of the top row 
L2 is the bit pattern of the second row from top, and so on until... 
L8 is the bit pattern of the bottom row. 


What is a bit pattern? Each dot in any one row is given a number, and the 
bit pattern is the sum of the numbers corresponding to those bits in 
foreground, These numbers, labelling the bits from left to right, are 128 
(for the leftmost pixel), 64, 32, 16, 8, 4, 2, 1 (for the rightmost pixel). 
Specific examples are easiest to understand. 
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The space character obviously has no foreground, thus all the bit 
patterns are zero, so to assign the space character to the code of 224, the 
command 


VDU 23,224,0,0,0,0,0,0,0,0 


would be used. To define a large X, the top line has the left and rightmost 
pixels set only, thus L1=128+1=129. The next line has the second from 
left and the second from right pixels set, thus L2=64+2=66. Similarly, 
L3=32+4=36 and L4=16+8=24. The fifth through to eighth rows are 
the mirror image of the first four, so to define the character 225 as an 
X, type the following line: 


VDU 23,225,129,66,36,24,24,36,66,129 [Jammy 


To display the character, type VDU 225 Gigguii! 


All the characters from 32 to 255 may be defined, but to define those 
outside the codes 224-255 it is necessary to allocate more memory for 
the fount. This is called ‘exploding the fount’ and is done via FX call 
number 2¢. 


Here is another example of defining a character. The alien in the 
BUGZAP program on the Introductory Cassette was made up on the 
matrix in the drawing below. 


a 
b 
c 
d 
e 
f 
& 
h 


Tf you use the code 224 for the new character definition, here is the VDU 
statement which defines the complete character: 


VOU 23,224,24,68,126,219,126,36,66,129 Flap 


By changing L7 and L8, the ‘upright’ alien shown in the drawing below 
can be defined. The code for this character must be a different one from 
the one above (eg 225), otherwise you will lose the original alien. 
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a 
b 
c 
d 
e 
f 
g 
h 


Have a go at defining this new character, then check the result by 
displaying it on the screen with 


vou 225 Giggle 


The program below shows how you can produce an animated alien by 
using both these characters. 


1@ VOU 23,224,24,60,126,219,126,36,66,129 

20 VOU 23,225,24,60,126,219,126,36,36,36 

30 MODE 2 

40 VDU 23,1,0;0;0;08 

50 REPEAT 

60 PRINT TAB(10,16);CHRS (224) 

70 NOW% = TIME : REPEAT UNTIL TIME = NOW%+25 
8@ PRINT TAB(1@,16); CHR$(225) 

98 NOW% = TIME : REPEAT UNTIL TIME 
12@ UNTIL FALSE 


NOW%+25 


Line 4 gets rid of the flashing cursor, which would otherwise be a 
distraction. You can retrieve it by typing 


voU 23,1,1;0;0;9;0 GME 


Graphics 
Introduction 


The graphics instructions are pretty extensive in the Electron, and they 
all have certain things in common. The easiest commands to understand 
are the MOVE and DRAW commands, and these will be used for 
illustration in the following section. The ideas presented here are true for 
all graphics commands (including SL&). 
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REMEMBER: when you press I BREAK the computer is in mode 6. This 
is not a graphics mode and nothing will happen when you try to plot 
things. Always remember to go into a graphics mode to try these things 
out. Mode 1 is a good one to start with. Similarly, programs should always 
have a MODE command in them, as described at the beginning of this 
chapter. 


The graphics coordinate system 

Firstly, we must describe the coordinate system, that is to say how 
positions of points are labelled. This is similar to the text coordinate 
system but there are three differences. 


Firstly the system has the point (9,8) in the bottom left hand corner, and 
row numbers are labelled upwards. 


Secondly, the top right hand point on the screen is (1279,1923), the same 
in all modes (see the drawing below). This is so that drawing a line from, 


say (199,199) to (499,499) always draws a line in the same place, even 
though the pixel size varies with the mode. 


Lastly, points off the screen are well defined, that is to say, drawing a line 
from, say (—399,—498) to (399,499) is perfectly legal, and what appears is 
what you would expect — that portion of the line that is in the area viewed 
by the screen, 


The graphics screen 


1423 


7 


@ ————_+> X 1279 


The graphics cursor is an invisible point on the screen, and is where you 
are about to draw from. Move it about the screen with the MOVE 
command, and drawing is easiest with the DRAW command. Thus 
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Move 100,100 Gamln 
DRAW 400,400 Glaun 


moves the cursor to (199,19@) and draws a white line to (499,499). Try 
lots of lines in different modes to get the feel of the coordinate system. 


The GCOL command 

Just as the foreground and background colours of text were defined 
using the COLOUR command, so the corresponding colours in graphics 
are defined using the GEOL command. Try the following: 


move 1 Glan 
tM PR RETURN 


DRAW 360,306 [Eyanryy 


This draws a line in colour 1 (red) from (9,@) — where the graphics cursor 
is when the mode is changed — to (309,389). However, you will notice that 
the GCOL command has two numbers after it. The second is just like the 
COLOUR command’s number, that is the foreground colour number, or, if 
128 is added to it, the background colour number. CLG is the graphics 
equivalent of CLS and clears the graphics area to the current graphics 
background colour. Thus 


GCOL oy Gai 


CLG 


sets the graphics background colour to 1 and clears the graphics screen 
to this colour (red). Note that the CLG command is much slower than the 
CLS command. 


The first number in the GCOL command is unusual. It tells the computer 
what to do with the graphics point. The following values are defined: 


@ - write the point to the screen (what one would normally expect). 

1 — OR the point to be plotted with what is on the screen. 

2-- AND the point to be plotted with what is on the screen. 

3 — EOR the point to be plotted with what is on the screen. 

4 — INVERT what is on the screen, regardless of what colour is to be 
plotted. 

5 — leave what is on the screen alone. 
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Other values do stripey things which may change with different releases 
of the software. 


What is meant by OR, AND, EOR and INVERT? Each pixel has a colour 
—in mode 1 with four colours, this is from @ to 3, or 4G, $1, 16 and 11 in 
binary. What appears on the screen is the result of a logical operation 
between the pixel you want to plot and what is already on the screen. The 
OR and the AND are the same as for the BASIC commands. EOR means 
‘exclusive OR’, whichis the same as OR unless both bits are one, in which 
case the result is zero. Again, all this is most easily explained by specific 
examples. The following assumes that you are in mode 1. 


Assume there is a red screen (from GCOLQ,129 :CLG, above). Setting 
GCOL 1,2 sets the foreground colour to 2 (19 in binary), and the colour 
‘mode’ to OR. Drawing a line then takes the red pixel on the screen (red~— 
colour 1 = 1 in binary), and ORs it with the yellow pixels you are 
plotting. The pixel colour that appears is the $1 ORed with 14, which is 
11, colour 3, which is white. (Try it). 


Given this white line on a red background, set the colour with GCOL 2,2, 
which has foreground colour 2 and colour mode AND. Plotting a line then 
takes what is on the screen and ANDs it with the yellow pixel, colour 2 or 
19 in binary. Therefore when the line is plotting on the red background, 
G1 (red) is ANDed with 19 (yellow), then result being 0@ (black). If it 
crosses the white line — the white pixels (11) are ANDed with the yellow 
pixels (19) to give 19 (yellow). 


Setting GCOL 3,131 sets the background colour to 3 (white) and the 
colour mode to EOR. Doing a CLG then EORs its pixel with 11—that is to 
say 06 goes to 11, 91 to 14, 1M to $1 and 11 to 9G. The screen is thus 
inverted in colour, and repeating the command restores it to its original 
state. 


If this does not seem too clear, playing around with it for a little should 
help. It has two main purposes — setting the EOR mode allows erasure of 
a line by plotting it again. In four colour modes, two independent two- 
colour pictures may be drawn and selectively displayed using the palette. 


Graphics 99 


The PLOT command 
MOVE and DRAW are two special cases of the more general PLOT 
command, which is as follows. 


PLOT K%,X%,Y% 


where K% is the plot mode (ie what you are actually going to do); X% and 
Y% are the coordinates of the point to which you are plotting. 


K% takes the following values: 
1) Draw a line, relative (that is X% and Y% are displacements 


from the current graphics cursor position), with no change 
on the screen. 


1 As @, but draw in foreground colour. 

2 As @, but invert what is on the screen (colour mode 4 
forced). 

3 As @, but draw in background colour. 

4to7 As % to 3 but plot absolute (plot to the point X%,Y%). 

8 to 15 As to 7, but plot the last point twice. This is so that when 


plotting in inverted modes, the line is continuous. 
16 to 31 As 9 to 15 but with a dotted line. 
32 to 63 Reserved for the graphics extension ROM. 
64 to 71 As % to 7, but plot the specified point only. 
72 to 79 Fill sideways on background colour (see below). 
89 to 87 Plot triangles (see below). 
88 to 95 Fill right on non-background colour (see below). 
96 to 255 Reserved for graphics extension ROM. 
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Triangle plotting 

This plots a solid triangle using as vertices the point specified, the 
graphics cursor and the previous graphics cursor. This can be used to fill 
many different shapes. 


Sideways filling on background colour 

This plots the line sideways from the specified point, left and right, until 
either the edge of the window is reached or the line meets a pixel of non- 
background colour. The graphics cursor is set to one of the end points, 
and the previous graphics cursor (used in triangle plotting) to the other. 
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The values of these may be found out via FX call number 13 (decimal). If 
the point specified is outside the graphics window, or is not on 
background colour, then the Y coordinates of the returned points are 
different. 


Filling right 

Filling right until background colour plots right from the specified point 
as far as either the edge of the graphics window or a pixel of background 
colour is found. The endpoints (note that it does not go left) are 
retrievable via FX 13 in the same way. The endpoint is actually the first 
pixel of background colour found, thus if the specified point is back- 
ground colour, the endpoint returned is the same as the specified one. 


These two routines together enable a fast routine to be constructed to fill 
any enclosed shape. 


The VDU command 

The VDU command writes a series of bytes to the screen in a similar way 
to the PRINT command. Thus the following two commands are exactly 
the same: 


VDU 12,65,66,67 


PRINT CHRS(12); CHRS(65); CHR$(66); CHRS(67 
3 


(Note the semicolon at the end of the PRINT statement — the VDU 
command does not send a carriage return unless you explicitly tell it to), 
Most numbers that you need to write to the VDU are single bytes 
(characters, for example). However, the graphics coordinates are all 
double byte quantities and are sent lower byte first, higher byte second. 
The VDU command enables this to be done easily. If a number in the VDU 
command is followed by a semicolon, that number is interpreted as a 
double byte quantity. If you are unsure of bytes and double bytes, the 
quick rule is that if you are doing a graphics operation using the VDU 
command, you must always follow a graphics coordinate with a semi- 
colon. This only applies to the VDU command. 


There are two more graphics commands, both of which are done via the 
VDU command. 
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Graphics windows 

Just as text may have a text window defined, outside of which no text 
command has effect, so a graphics window may be similarly defined. This 
is done with 


VOU 24,L%z;BX3R45T%;3 


where L%,B% and R%,T% are the coordinates of the lower left and upper 
right pixels inside the window. Setting a window thus prevents any 
plotting outside it. Also, because CLG is just another plot command, 
defining a graphics window and doing a CLG is a quick way of plotting 
rectangles, 


1923 


d 


Graphics 
window 


9 1279 


The graphics origin 

So far it has been said that the point (9.8) is at the bottom left hand 
comer of the screen. This point (called the origin) may be specified to live 
elsewhere with the origin command. 


VDU 29, X%s YR; 


sets the position of the origin on the screen for future graphics 
commands. Thus to set the origin in the middle of the screen, use VDU 
29,649:512:. It does not move the physical position of what is on the 
screen, the graphics windows or the graphics cursor. 
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Plotting characters 

If VDU 5 is entered, the text and graphics cursors are said to be joined, 
that is text appears at the graphics cursor which then moves as the text is 
written, This is mainly used for labelling graphs. The graphics cursor 
points to the top right pixel of the 8 by 8 character cell to be written, and 
is moved 8 pixels along by writing letters. This is seen in the following 
program. 


180 MODE1 

20 vDU5 

3@ REM ALL the text now appearing is 'plott 
ed' 

40 DRAW 500,500 

5@ PRINT "Hello mummy"; 

6@ REM the last print statement moved the g 
raphics cursor 

70 REM as can be seen by the next plot st 
atement. 

8@ DRAW 0,0 

90 END 


VDU4 restores the text cursor. 


The palette 


Colours defined through the COLOUR and GCOL commands are more 
properly referred to as logical colours. When a mode is changed, these 
logical colours appear as certain physical colours, thus in mode 1, colour 
lis red and colour 2 is yellow. The palette allows this to be changed, thus 
colour 1 may be made to be blue and colour 2 flashing black on white. To 
be exact, we must distinguish between two types of colour: 


The logical colour is what is output by the COLOUR commands. The 
maximum logical colour is limited by the number of colours available in 
the mode. 


The physical colour is what appears on the screen. The physical colours 
and their numbers are listed below. 
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Physical number Display colour 

Black 

Red 

Green 

Yellow 

Blue 

Magenta 

Cyan 

White 

Flashing black/white 
Flashing red/cyan 

16 Flashing green/magenta 
11 Flashing yellow/blue 

12 Flashing blue/yellow 

13 Flashing magenta/green 
14 Flashing cyan/red 

15 Flashing white/black 
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Each logical colour has a physical colour assigned to it, which may be 
changed by reprogramming the palette. This is done as follows: 


VDU 19,L%,P%,0,0,08 


where L% is the logical colour and P% is the physical colour. So in mode 1, 
to change all the pixels with logical colour 3 (usually white) to blue 
(logical colour 4), the command VOU 19,3,4,8,9.8 is used. Thus while the 
very detailed mode @ is a two colour mode, the colours themselves may 
be anything available from the palette, such as green on red. Note also 
that the palette reprogramming is very fast as it does not involve a lot of 
the screen memory being reprogrammed. 


21 VDU codes 


Introduction 


The statement VDU X is equivalent to PRINT CHRS(X); and the statement 
VOU X,Y,Z is equivalent to PRINT CHR$(X);CHRS(Y);CHRS(Z); 


However the VOU statement finds most common use when generating 
ASCII control codes and a detailed description of the effect of each 
control code is given in this chapter. The control codes are interpreted by 
part of the machine operating system called the VDU driver. 


The VDU drivers interpret all 32 ASCII control character codes. Many of 
the ASCII control codes are followed by a number of bytes. The number 
of bytes which follow depends on the function to be performed. The VDU 
code table summarises all the codes and gives the number of bytes which 
follow the ASCII control code. 


Detailed description 


4 This code causes text to be written at the text cursor, ie in the normal 
fashion. A MODE change selects VDU 4, normal operation. 


5 This code causes text to be written where the graphics cursor is. The 
position of the text cursor is unaffected. Normally the text cursor is 
controlled with statements such as 


PRINT TAB(5,1@) 
and the graphics cursor is controlled with statements like 
MOVE 700,450 


Once the statement VDU5 has been given only one cursor is active (the 
graphics cursor). This enables text characters to be placed at any 
position on the screen. There are a number of other effects: text 
characters overwrite what is already on the screen so that characters can 
be superimposed; text and graphics can only be written in the graphics 
window and the colours used for both text and graphics are the graphics 
colours. In addition the page no longer scrolls up when at the bottom of 
the page. Note however that POS and VPOS still give you the position of 
the text cursor. 
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VDU code table 
TT 
TT ls 
q 2/8 
i = 
5 x 2 oD 5 g 
o Dis | p> 
A }m|O| t's] | Meaning 
1] @ | @|NUL | 9 | Does nothing 
1 1 | A |SOH } 1 | Reserved 
2 | 2 1B |STX | @ | Reserved 
3 3 |C |ETX | @ | Reserved 
4 4 |D |EOT | @ | Write text at text cursor 
5 5 | E |ENQ] @ | Write text at graphics cursor 
6 | 6 | F | ACK | @ | Enable VDU drivers 
7 | 7] G|BEL | @ | Make a short beep 
8 8 |H|BS % | Backspace cursor one character 
9 9/I | HT @ | Forwardspace cursor one character 
19 | A|J | LF 9 | Move cursor down one line 
11 | B|K |VT_ | @ | Move cursor up one line 
12 | C|L |FF @ | Clear text area 
13 | D|MJ]CR_ | @ | Move cursor to start of current line 
14] E|]N {SO @ | Page mode on 
15} F|O/SI @ | Page mode off 
16 | 1¢|P | DLE | @ | Clear graphics area 
17 | 11 | Q@ | DC1 | 1 | Define text colour 
18 | 12 | R | DC2 | 2 | Define graphics colour 
19 |13 |S }|DC3 | 5 | Define logical colour 
26 | 14 | T | DC4 | @ | Restore default logical colours 
21 |15 | U |NAK| @ | Disable VDU drivers or delete current 
line 
22 | 16 | V | SYN | 1 | Select screen mode 
23 |17 | W1}ETB | 9 | Re-program display character 
24 | 18 | X | CAN | 8 | Define graphics window 
25|19|Y |EM | 5 | PLOT Kxy 
26 | 1A |Z | SUB | @ | Restore default windows 
27|1B|[ | ESC | @ | Reserved 
28|1C|\ [FS | 4 | Define text window 
29) 1D)|] |GS 4 | Define graphics origin 
36 | 1E] ARS | @ | Home text cursor to top left 
31 | 1F | —| US 2 | Move text cursor to x,y 
127 | 7F he DEL | @ | Backspace and delete 
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6 VDU 6 is a complementary code to VDU21. VDU21 stops any further 
characters being printed on the screen and VDU6 re-enables screen 
output. A typical use for this facility would be to prevent a pass-word 
appearing on the screen as it is being typed in. 


7 This code,which can be entered in a program as VDU7 or directly from 
the keyboard as [4 fi19 G, causes the computer to make a short ‘beep’. 


8 This code (VDU8 or [419 H) moves the text cursor one space to the 
left. If the cursor was at the start of a line then it will be moved to the end 
of the previous line. It does not delete characters — unlike VDU 127. 


9 This code (VDU 9 or [G19 1) moves the cursor forward one charac- 
ter position. 


10 The statement (VDU 10 or [G19 J) will move the cursor down one 
line. If the cursor is already on the bottom line then the whole display will 
normally be moved up one line. 


11 This code (VDU11 or K) moves the text cursor up one line. If 
the cursor is at the top of the screen then the whole display will move 
down a line. 


12 This code clears the screen — or at least the text area of the screen. 
The screen is cleared to the text background colour which is normally 
black. The BASIC statement CLS has exactly the same effect as VDU12 
or L. This code also moves the text cursor to the top of the text 
window, 


13 This code is produced by the key. However its effect on 
the screen display if issued as a VDU13 or PRINT CHRS(13); is to move the 
text cursor to the left hand edge of the current text line (but within the 
current text window, of course). 


14 This code makes the screen display wait at the bottom of each page. 
It is mainly used when listing long programs to prevent the listing going 
past so fast that it is impossible to read. The computer will wait until a 
key is pressed before continuing. This mode is called ‘paged 
mode’. Paged mode is turned on with the N and off with rcTAL 0. 


15 This code causes the computer to leave paged mode. See the 
previous entry (14) for more details. 


16 This code (VDU 16 or [U9 P) clears the graphics area of the screen 
to the graphics background colour and the BASIC statement CLG has 
exactly the same effect. The graphics background colour starts off as 


VDU codes 197 


black but may have been changed with the GCOL statement. vDU 
16 does not move the graphics cursor — it just clears the graphics area of 
the screen. 


17 VDU 17 is used to change the text foreground and background 
colours. In BASIC the statement COLOUR is used for an identical 
purpose. VDU17 is followed by one number which determines the new 
colour. See the BASIC keyword COLOUR for more details. 


18 This code allows the definition of the graphics foreground and 
background colours. It also specifies how the colouris to be placed on the 
screen. The colour can be plotted directly, ANDed, ORed or Exclusive- 
ORed with the colour already there, or the colour there can be inverted. 
In BASIC this is called GCOL. 


The first byte specifies the mode of action as follows: 


® Plot the colour specified 

1 OR the specified colour with that already there 

2 AND the specified colour with that already there 

3 Exclusive-OR the specified colour with that already there 
4 Invert the colour already there 


The second byte defines the logical colour to be used in future. If the byte 
is greater than 127 then it defines the graphics background colour 
(modulo the number of colours available). If the byte is less than 128 then 
it defines the graphics foreground colour (modulo the number of colours 
available). 


19 This code is used to select the actual colour that is to be displayed for 
each logical colour. The statements COLOUR (and GCOL) are used to 
select the logical colour that is to be used for text (and graphics) in the 
immediate future. However the actual colour can be re-defined with VDU 
19. For example 


MODE 5 
COLOUR1 


will print all text in colour 1 which is red by default. However the 
addition of 


VDU 19,1,4,0,0,@ or VDU 19,1,4;8; 
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will set logical colour 1 to actual colour 4 (blue). The three zeros after the 
actual colour in the VOU 19 statement are for future expansion. 


In MODE 5 there are four colours (9,1,2 and 3). An attempt to set colour 
4 will in fact set colour @ so the statement 


VOU 19,4,4,0,0,0 or VDU 19,4,4;0; 
is equivalent to 
VDU 19,0,4,0,0,0 or VDU 19,0,4;@; 


We say that logical colours are reduced modulo the number of colours 
available in any particular mode. 


29 This code VDU29 or [AGT9 T sets default text and graphic 
foreground logical colours and also programs default logical to actual 
colour relationships. The default values are: 


Two colour modes 
6=black 
1=white 


Four colour modes 
0=black 
1=red 
2=yellow 
3=white 
Sixteen colour modes 
@=black 
1=red 
2=green 
3=yellow 
4=blue 
5=magenta 
6=cyan 
7=white 
8=flashing black/white 
9=flashing red/cyan 
19=flashing green/magenta 
11=flashing yellow/blue 
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12=flashing blue/yellow 
13=flashing magenta/green 
14=flashing cyan/red 
15=flashing white/black 


21 This code behaves in two different ways. If entered at the keyboard 
(as ) CTRL ISD) it can be used to delete the whole of the current line. It is 
used instead of pressing the key many times. If the code is 
generated from within a program by either VDU21 or PRINT CH R$ (21); it 
has the effect of stopping all further graphics or text output to the screen. 
The VDU is said to be disabled. It can be ‘enabled’ with VDU6. 


22 This VDU code is used to change MODE. It is followed by one 
number which is the new mode. Thus VDU22,6 is exactly equivalent to 
MODEG (except that it does not change HIMEM). 


23 This code is used to re-program displayed characters. The ASCII 
code assigns code numbers for each displayed letter and number, The 
normal range of displayed characters includes all upper and lower case 
letters, numbers and punctuation marks as well as some special symbols. 
These characters occupy ASCII codes 32 to 126. If the user wishes to 
define his or her own characters or shapes then ASCII codes 224 to 255 
are left available for this purpose. In fact you can re-define any character 
that is displayed, but extra memory must be set aside if this is done, and 
this is explained in Appendix D. 


ASCII codes @ to 31 are interpreted as VDU control codes — and this 
chapter is explaining the exact function of each. Thus the full ASCII set 
consists of all the VDU control codes, all the normal printable characters 
and a user defined set of characters. 


For example if the user wishes to define ASCII code 246 to be a small 
triangle then the following statement would have to be executed. 


character to be 
re-defined 


Aa 
VDU 23,240,1,3,7,15,31,63,127,255 
hava = = 


re-define 8 numbers giving the contents of each row of dots that 
character makes up the desired character 
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=1 

2+1=3 
44+2+1=7 
8+4+24+1=15 


16+8....=31 


As explained above the user may define any ASCII code in the range 224 
to 255. To display the resultant shape on the screen the user can type 


PRINT CHR$(240) or 
VDU 240 


In the unlikely event of the user wishing to define more than the 32 
characters mentioned above (ASCII 224 to 255) it will be necessary to 
allocate more RAM for the purpose. 


24 This code enables the user to define the graphics window — that is, 
the area of the screen inside which graphics can be drawn with the DRAW 
and PLOT statements. The graphics screen is addressed with the 
following coordinates. 


1923 


a 
tat 


1279 
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Thus the coordinates of A would be approximately 1604,200. 


When defining a graphics window four coordinates must be given; the 
left, bottom, right and top edges of the graphics area. Suppose that we 
wish to confine all graphics to the area shown below. 


TT 


Graphics 


area 


9 154 1190 


The left hand edge of the graphics area has an X value of (about) 159. 
The bottom of the area has a Y value of 309. The right hand side has 
X=1169 and the top has Y=79. The full statement to set this area is 


VDU 24,150; 300; 1100; 7068; 


Notice that the edges must be given in the order left X, bottom Y, right 
X, top Y and that when defining graphics windows the numbers must be 
followed by a semi-colon. 


For those who wish to know why trailing semi-colons are used the reason 
is as follows: X and Y graphic coordinates have to be sent to the VDU 
software as two bytes since the values may well be greater than 255. The 
semi-colon punctuation in the VDU statement sends the number as a two 
byte pair with low byte first followed by the high byte. 


25 This VDU code is identical to the BASIC PLOT statement. Only those 
writing machine code graphics will need to use it. VDU25 is followed by 
five bytes. The first gives the value of A referred to in the explanation of 
PLOT in the BASIC keywords chapter. The next two bytes give the X 
coordinate and the last two bytes give the Y coordinate. Refer to the 
entry for VDU24 for an explanation of the semi-colon syntax used. Thus 


VOU 25,4,100; 500; 


112 VDU codes 


would move to absolute position 166,500. 
The above is completely equivalent to 


VDU 25,4,100,0,244,1 
x Y 


26 The code VOU 26 (Gi Z) returns both the graphics and text 
windows to their initial values where they occupy the whole screen. This 
code re-positions the text cursor at the top left of the screen, the graphics 
cursor at the bottom left and sets the graphics origin to the bottom left of 
the screen. In this state it is possible to write text and to draw graphics 
anywhere on the screen. 


28 This code (VDU28) is used to set a text window. Initially it is possible 
to write text anywhere on the screen but establishing a text window 
enables the user to restrict all future text to a specific area of the screen, 
The format of the statement is 


VOU 28,leftX,bottomY,rightX,topY 
where leftX sets the left hand edge of the window 
bottomY sets the bottom edge 


rightX sets the right hand edge 
topY sets the top edge 


Y1 


sf tant 


X2 ——| 


~ 
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For the example shown the statement would be 
VDU 28,5,20,30,12 


Note that the units are character positions and the maximum values will 
depend on the mode in use. The example above refers to MODE1 and 
MODE4. In MODES 2 and 5 the maximum values would be 19 for X and 
31 for Y since these modes have only 29 characters per line. 


g —_—_____» X 19 


v7] 


< 


31 
29 This code is used to move the graphics origin. The statement VDU29 
is followed by two numbers giving the X and Y coordinates of the new 
origin. The graphics screen is addressed 


1923 


eC 


8 


¢—— 1279 


Thus to move the origin to the centre of the screen the statement 


vVDU 29,646; 512; 


114 VDU codes 


should be executed. Note that the X and Y values should be followed by 
semi-colons. See the entry for VDU24 if you require an explanation of the 


trailing semi-colons. Note also that the graphics cursor is not affected by 
vbuz29. 


30 This code (VDU 34 or PUL9 A ) moves the text cursor to the top left 
of the text area. 


31 The code VDU31 enables the text cursor to be moved to any 
character position on the screen. The statement VDU31 is followed by 
two numbers which give the X and Y coordinates of the desired position. 


Thus to move the text cursor to the centre of the screen in MODE 7 one 
would execute the statement 


vou 31,20,12 


Note that the maximum values of X and Y depend on the mode selected 
and that both X and Y are measured from the edges of the current text 
window not the edges of the screen. 


32-126 These codes generate the full set of letters and numbers in the 
ASCII set. 


127 This code moves the text cursor back one character and deletes the 
character at that position. VDU127 has exactly the same effect as the 
ystaly key. 


128-223 These characters are normally undefined and wil! produce 
random shapes. 


224-255 These characters may be defined by the user using the 
statement VDU23. It is thus possible to have 32 user defined shapes such 
as 


Syou 23,224,8,28,28,107,127,107,8,28 
@vOU 23,225,8,28,62,127,62,28,8,0 
@vou 23,226,54,127,127,127,62,28,8,0 
@VDU 23,227,8,28,62,127,127,127,28,62 


Try typing each of the lines above, remembering to press the Glatht) 
key after each definition. To display any of the new definitions, type in 
the appropriate VDU code. For example, to display the heart, type 


VDU codes 115 


vou226 DiGi! 


Character definitions 224 to 255 are stored in a block of memory 
reserved for them in the computer. If however, you need more 
characters, or you want to re-define some of the keyboard characters, the 
best way to do this is to tell the computer to set aside extra memory to 
store them. (If you don’t, you may run into problems). The operating 
system call *FX2@ described in Appendix D enables you to do this. 
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Introduction 


Inside the Electron is a sound synthesiser which you can program to 
generate virtually any sound you like. The synthesiser is controlled by 
two BASIC commands: SOUND and ENVELOPE, and each command 
requires you to type in a series of numbers (or parameters) after it. These 
parameters determine the type of sound you will hear from the 
Electron’s internal loudspeaker; ie the type of sound, pitch, duration, 
and so on. 


There is a vast range of parameter values which gives you an almost 
unlimited range of possibilities when writing programs for the synthe- 
siser. However, you don’t need to be a wizard in order to use the sound 
system on a relatively simple level, and this chapter will serve to get you 
started. Once you’ve had some practice, read the last section in this 
chapter which goes into the SOUND commands in more detail. 


The SOUND command 


The SOUND command must be followed by four parameters which we 
will call @, A, P and D. So the SOUND command takes the form 


SOUND @,A,P,D 


Selects SOUND channel number___ 


Switches the sound on/off or selects ENVELOPE 
Selects the pitch of the sound 
Selects the duration of the sound 


Press ) ESCAPE | and type the following: 
SOUND 1,-15,0,169 [Tigi 
This will produce a single tone of fairly long duration. Type this line in 


again and increase the P parameter (the third number). You'll notice that 
the pitch increases. 
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The Q parameter 


There are four values of Q, and each one selects the SOUND channel 
number. 


Q=6 Channel 9, selects noise 
Q=1 Channel 1, selects tone 
Q=2 Channel 2, selects tone 
Q=3 Channel 3, selects tone 


You may wonder why there are three SOUND channels which all select 
tone as opposed to noise. The only reason for this is to make the sound 
system as compatible with the BBC Microcomputer as possible. From 
now on, we will ignore channels 2 and 3. 


The A parameter 
This parameter does three things, depending on the value you give it: 


When A is a negative number, the amplitude is at maximum, ie ‘on’. 
When A is zero, the amplitude is at minimum, ie ‘silence’. When A is 
between 1 and 16 inclusive, an ENVELOPE command of the same number 
is selected. Forget the ENVELOPE command for the moment, you will 
meet it later in this chapter. 


Note that for the sake of compatibility with the BBC Microcomputer, use 
A=-15 for ‘sound on’, and A=@ for ‘silence’. 


The P parameter 

The value of this parameter controls the pitch of the generated sound. 
The range of values are from § to 255, and each consecutive value will 
give a quarter-semitone pitch change. The lowest note (P=9) is the B one 
octave and a semitone below middle C, and the highest accurate note is 
the B above middle C (P=199). Although values above P=199 are not 
accurate to the even-tempered scale, they can still be put to good use for 
making sound effects. The table below is a quick reference guide to help 
you find the pitches you want. 
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Octave number 
Note 1 2 3 4 5 6 
B 1) 48 96 144 192 246 
Cc 4 *52 100 148 196 244 *middle C 
C# 8 56 194 152 200 248 
D 12 6¢ 108 156 204 252 
D# 16 64 112 169 208 
E 26 68 116 164 212 
F 24 72 126 168 216 
FH 28 76 124 172 226 
G 32 8¢ 128 176 224 
G# 36 84 132 186 228 
A 40 88 136 184 232 


When the noise channel (channel ) is selected, the P parameter has the 
following effect: 


P= Tone — high pitch 

P=1 Tone — intermediate pitch 
P=2 Tone - low pitch 

P=3 Tone — intermediate pitch 
P=4 Noise — short period 

P=5 Noise — intermediate period 
P=6 Noise — long period 

P=7 Noise ~ intermediate period 


The D parameter 

The value of this parameter sets the duration of the tone in steps of 
5@mS. So if D=149, then the duration will be (190 X 59)/1099, or five 
seconds. The maximum value of D is 254 (12.75 seconds). 


If D=-1, then the tone will carry on until it is turned off. 


Using the SOUND command in a program 


Before using the SOUND command in a program, try following through 
the example below, in order to produce a single sound. 


First of all, decide which channel to use: channel ¢ will give noise, so use 
one of the three tone producing channels, say channel 1. So the first 
number is 1 — this is the value of Q. 
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Now choose the value for the second number — the A parameter. At the 
moment we aren’t using any ENVELOPEs, and we want to hear the sound, 
so the next number is —15 — this is the value of A. 


The third number—the P parameter— determines the pitch. If you look at 
the pitch table, the C below middle C is the value 4. So P=4. 


How long shall the sound last? The fourth number - the P parameter — 
gives the duration in 5@mS (five hundredths of a second). So for a 
duration of five seconds, P=19¢. 


Now type the following SOUND command with the number above: 


SOUND 1,-15,4,100 Gigmuiis 


This produces a tone which lasts for five seconds, and is the C below 
middle C. 


Remembering that the pitch value is in quarter semitone steps, then to 
produce the sound corresponding to C (one semitone higher than the 
previous one), we must increase the pitch value by four. 


SOUND 1,-15,8,100 Dall 


To play the next note up the scale, increase the P parameter by four 
again, and so on. 


Instead of using numbers in the SOUND command, you can incorporate 
the SOUND command into a program, and use real or integer variables 
(see chapter 11), For example, let’s produce a chromatic scale over an 
octave (equivalent to playing every note in sequence ona piano keyboard 
over an octave). 


Instead of having to type in 13 SOUND commands to get the 13 different 
notes in the scale, we can use a variable for the P parameter, and change 
the variable value 13 times by using a FOR . . . NEXT loop. Try the 
program below which demonstrates this. 


5 REM chromatic scale starting at C below m 
iddle C up to middle C 

10 FOR X%Z=4 TO 52 STEP 4 

2@ SOUND 1,-15,X%,5 

3@ NEXT 
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Lines 14 and 39 set up a loop with variable X%, whose values are passed 
to the pitch parameter in line 29. Line 29 contains the SOUND command: 
channel 1 is selected, the sound is ‘on’ (A=—15), the pitch is determined 
by the value of X%, and each sound plays for 5 X 5@mS, or 9.25 seconds. 


As you can hear, each new note only starts after the one before has 
finished. If you want to put a pause between each note, insert another 
SOUND command between lines 29 and 34, but turn it ‘off’ by giving the A 
parameter value g. The length of the pause will of course be decided by 
the value you give the last parameter. Try this line: 


25 SOUND 1,0,X%,10 


(Obviously, the pitch value here can be anything you like). Now list the 
program. 


5 REM chromatic scale starting at C below m 
iddle C up to middle C 

1@ FOR X%=4 TO 52 STEP 4 

20 SOUND 1,~-15,X%,5 

25 SOUND 1,8,X%,18 

30 NEXT X% 


When you RUN this program, you will hear a pause between each note. 
Try changing the values of X% and the duration of the tones and pauses 
to get different effects. If you want to make a crude sequencer, put the 
complete program into a REPEAT... . UNTIL FALSE loop. 


ENVELOPE 


Each SOUND command, as we have seen, allows you to generate a single 
tone, whose pitch and duration is defined by you within the SOUND 
command. The ENVELOPE command allows you to change the single tone 
into something far more complex. Try typing the following: 


1@ SOUND 1,2,108,100 


If you run this, you will hear a continuous tone which lasts for five 
seconds. Now add this line: 


20 ENVELOPE 2,1,4,-4,4,10,20,18,0,0,0,0,0,0 
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When you run this program, you'll hear a sound rather like a police siren. 
Ignore all the numbers after the ENVELOPE command, except for the very 
first one, which defines the ENVELOPE number, in this case 2. The second 
parameter in the SOUND command selects ENVELOPE number 2; 
(ENVELOPE 2, . ..); the third parameter selects the starting pitch and the 
fourth parameter selects a duration of five seconds. 


Note that once an ENVELOPE statement has been executed, it will stay in 
the computer until it is either re-defined, or until the computer is 
switched off. So even if you delete line 2 in the program above, when you 
run the program ENVELOPE number 2 will still be selected and used. 


The ENVELOPE command 


The ENVELOPE command is followed by 14 parameters, each separated 
by acomma, To make life easier, only the first eight actually do anything 
on the Electron, but the rest must be included for the sake of 
compatibility with the BBC Microcomputer. These eight parameters are 
shown below, and are followed by six zeros to make up the 14 parameters 
necessary. 


ENVELOPE n,s,Pit,Pi2,Pi3,Pr1,Pr2,Pr3,0,0,0, 
0,0, 


If you want to run Electron programs containing ENVELOPE statements 
on the BBC Microcomputer, then you should get into the habit of always 
using the following numbers for the last six parameters: 


ENVELOPE XpXpXpX phe XoXoXo 126,0,8,-126,126,1 
26 


This will ensure that the resulting sound will be the same on both 
computers. For those of you who are not concerned with compatibility, 
use any numbers you like. In the rest of this section, ‘zeros’ have been 
used to save initially confusing you with too many numbers! 


The duration of the ENVELOPE effect varies, depending on the values in 
the ENVELOPE command. However, as long as the duration is less than 
that of its associated SOUND command, it will repeat itself until the 
SOUND command finishes. For example, if you set the duration of a 
SOUND command to five seconds and select an ENVELOPE which makes a 
‘WOW sound lasting for one second, then the result will be 
‘WOWOWOWOWOW.. With the ENVELOPE command, you can: 
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— Alter the SOUND pitch parameter by a specified increment 
- Specify how many increments you want 
— Set the length of time each increment ‘plays’ 


The length of each increment can only be specified once in the ENVELOPE 
command, but the increment value itself, and the number of increments 
can both be specified three times! 


Have a look at the graph below, which represents pitch plotted against 
time for an ENVELOPE command. As you can see, the resulting envelope 
contains three stages. In the first stage, the pitch increases by an 
increment of 1, then by —2 in the second stage, then 1 inthe third stage. In 
the first stage there are seven pitch increments, in the second stage five, 
and in the third stage 12. (Notice that the duration of every pitch 
increment is the same). 


Stage 1 H Stage 2 H Stage 3 | 


The first eight parameters of the ENVELOPE command are as follows. 


First parameter n 


This is the ENVELOPE number, and is selected by the second parameter 
of the SOUND command. Values are from 1 to 16. 


Second parameter s 

This gives the duration of every pitch change in the ENVELOPE command, 
(ie all three stages), and each value corresponds to 16mS. Values are 
from 9 to 255. Values 1 to 127 give durations of 1 X 19mS to 127 X 16mS, 
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and when the ENVELOPE is finished, it repeats itself until the duration of 
the associated SOUND command has run out. Values 128 to 255 are 
equivalent to 1 to 127, except that at the end of the ENVELOPE, the 
final pitch is held until the associated SOUND command has run out. 


Third parameter Pil 
This gives the value of every pitch increment during the first stage. Values 
are from —128 to 127. 


Fourth parameter Pi2 
This gives the value of every pitch increment during the second stage. 
Values are from —128 to 127. 


Fifth parameter Pi3 
This gives the value of every pitch increment during the third stage. 
Values are from —128 to 127. 


Sixth parameter Pr1 
This gives the number of pitch increments in the first stage. Values are 
from 1 to 255. 


Seventh parameter Pr2 
This gives the number of pitch increments in the second stage. Values are 
from 1 to 255. 


Eighth parameter Pr3 
This gives the number of pitch increments in the third stage. Values are 
from 1 to 255. 


Parameters 9 to 14 

These parameters must be put into the ENVELOPE command, but their 
values will have no effect on the effect produced by the Electron’s 
ENVELOPE command. In order to keep the command compatible with the 
BBC Microcomputer, these values should be 126,9,9,-126,126,126. 


Constructing an ENVELOPE 
Type in the following program: 


1@ SOUND 1,2,4,50 
20 ENVELOPE 2,1,1,72,1,7,5,12,0,0,0,0,0,0 
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If you run this, you will hear a whirring sound, The sound is being 
transmitted on channel 1, ENVELOPE 2 is selected, the pitch value is 4, 
and the sound lasts for 56 X 5@mS or 2.5 seconds. 


The graph below shows the effect of the ENVELOPE on the sound. This 
graph is exactly the same as the one at the beginning of this section on the 
ENVELOPE command, and was drawn using the parameter values in the 
ENVELOPE statement above. The parameters are as follows: 


n ENVELOPE number 2 
s Pitch change duration is 1 X 19mS 
Pil Stage 1 pitch changes INCREASE in increments of 1, (quarter 


semitones) 

Pi2 Stage 2 pitch changes DECREASE in increments of 2, (half 
semitones) 

Pi3 Stage 3 pitch changes INCREASE in increments of 1, (quarter 
semitones) 


Prl Number of pitch changes in stage 1 is 7 
Pr2 Number of pitch changes in stage 2 is 5 
Pr3_ Number of pitch changes in stage 3 is 12 


TIME ————— 
(steps of 19mS) 


Stage 1 { Stage2 | Stage 3 | 


The total time taken for this ENVELOPE command is 19mS X total 
number of pitch changes, or 24 X §.61 seconds, = 9.24 seconds. So the 
ENVELOPE is repeated over and over again, until the SOUND command 
finishes. 
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Additional SOUND features 


The first parameter of the SOUND command can be given extra values 
which provide you with some more facilities. To use these values, you 
must enter the first parameter as a four digit hexadecimal number (which 
must be preceded by a & sign, to tell the computer that a hexadecimal 
number follows). The four digits in this number can be represented by 
HOFC, and here is a description of each digit. 


H HOLD H = @ for compatibility with the BBC Micro- 
computer. 


O Notused, but should be entered with a value of 6 for compatibility. 


F FLUSH F=9@ sound is queued. This means that the sound 
won’t start playing until the previous one has 
finished. This is only true if the previous sound is on 
the same channel as this one. If the channel 
numbers are different, then the latest SOUND 
instruction to be executed by the computer will 
immediately start playing in place of the previous 
one. 


F=1 sound is not queued. This means that as soon 
as the sound is executed by the computer, any 
sound previously playing will immediately stop and 
be replaced by this sound. 


C CHANNEL C=%4 noise channel 
C = 1, 2 or 3 tone channels 


Example SOUND and ENVELOPE programs 


The program below turns the Electron into a keyboard instrument by 
using the 12345 and QWERTY keys. 


10 REM Keyboard - Caps Lock on! 

20 *FX12,4 

30 *FX11,4 

40 S$= " Q2WZERST6Y7UI90OP" 

5@ REPEAT 

68 SOUND &11,-15,INSTR(S$,GET$) *4,1 
7@ UNTIL FALSE 


126 Making sounds 


This next program takes a string of note names, and plays the notes. 
The range of notes you can play is from the C below middle C, to the B 
above middle C. To produce the full range in sequence enter the 
following: cdefgabC DEFGAB (RETURN). This will give you two octaves in 
the key of C major. 


1@ REM Tune player 

2@ $$ = "c¢ defgabC D EF G AB" 
3@ REPEAT 

40 INPUT "=>" TS 

5@ FOR N% = 1 TO LEN TS 

60 P% = INSTR(S$,MIDS(TS,N%,1)) 

7@ SOUND 1,-15,P%*4,4 

80 NEXT 

9@ UNTIL FALSE 


Laser Zap! This program uses an ENVELOPE with a downwards pitch 
sweep. To fire the laser, press any key. 


10 REM Zap! 

2@ ENVELOPE 1,129,-15,~-8,-3,10,18,10,126,0, 
@,-126,126,126 

30 REPEAT 

40 SOUND &11,1,255,5 

5@ UNTIL GET = FALSE 


This last program uses a repeated ENVELOPE with an upwards pitch 
sweep to produce a spaceship take-off sound. 


16 REM Liftoff 

2@ ENVELOPE 1,1,6,6,6,2,2,1,126,0,0,-126,12 
6,126 

3@ FOR S% = @ TO 220 

4@ SOUND 1,1,8%,1 

5@ NEXT 
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indirection operators 


The Electron’s memory 


The computer’s memory consists of 65536 locations (@ to 65535), each 
containing 1 byte (8 binary digits). Half of the computer’s memory can be 
written to or read from (called RAM); the other half can only be read from 
(called ROM). 


Each location in memory has a unique address (like the address of your 
house) which is a four digit hexadecimal number. Location ¢ in memory 
is &4000 and location 65535 is &FFFF. The & sign means that the 
numbers which follow are in hexadecimal. The easiest way to look at the 
computer’s memory is on a memory map. Overleaf is a simplified 
memory map for the Electron, showing on the right the address of each 
location. 


Looking at the memory map, see how it is divided into the two types, 
RAM and ROM. All the programming which went into making the 
machine work is stored in the upper half of the memory, from &80¢ to 
&FFFF. Your BASIC programs are stored, unless the computer is told 
otherwise, starting at location &$E 99. This position where the program 
starts is assigned to a resident variable called PAGE. PAGE is an address 
pointer; it tells the computer at which address to start executing a 
program when you tell it to RUN. The location at which the BASIC 
program finishes is also assigned to a variable, called TOP. If you type: 


PRINT TOP-PAGE (1aQih! 


the computer tells you how many bytes of memory your program fills. 


Note that future expansions of the Electron, eg a disc filing system, will 
move PAGE up. : 


The next address pointer is LOMEM. This tells the computer where it can 
store the variables which are used by your program, and is usually the 
same value as TOP. 
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Memory map 


Hex Decimal 
&FFFF 65535 
&FF OD 65289 


&FCOD 61512 


Operating system ROM 


Memory mapped input/output 


Operating system ROM 


&COOD 49152 


4 paged ROMs eg BASIC 


&8900 32768 


RAM used for 


high resolution graphics Movable boundary 


HIMEM “*r---~" S510 Stack 
32K RAM 
to &7FFF &4900 16384 
Movable boundary 
LOMEM _,| __‘ynamic variable storage | 
TOP 


&2000 8192 
User’s BASIC program area 


PAGE 


&EGO 3584 
Reserved for operating 


system use 


&O909 g 


The last address pointer is HIMEM. HIMEM shows the position of the 


bottom of the screen memory, so any program or variables must be kept 
below this value. 
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Programs are normally loaded at & PEGG, but they can be put higher up 
the memory by altering the value of PAGE. For example, if you make PAGE 
= &199, and then you LOAD a program from tape, it will be situated at 
address &19%@. When you do this, TOP and LOMEM are moved to their 
new position above the program. Another way in which to re-situate a 
program is to use *LOAD. 


*LOAD “program name" 1000 Giatiihl 


will LOAD the program from tape into the memory at location &1096. 
This instruction does not alter PAGE, and if you want to run the program 
you must make PAGE = &1909. 


Any section of memory can also be saved by using *SAVE. 
*SAVE "file name" SSSS FFFF EEEE Glad 


SSSS is the hex address from which you wish to start saving. 
FFFF is the hex address plus 1 at which you wish to finish. 


EEEE is the hex address at which execution should commence. 


Indirection operators 


Individual memory locations can be accessed from BASIC by using three 
indirection operators: 


Symbol Purpose Number of bytes 
affected 
? Byte indirection operator 1 
! Double-word indirection operator 4 
$ String indirection operator 1 to 256 


To illustrate this, set a variable to an address in memory, for example: 


A = &1000 Giatile 


7A will give the contents of location A, so the contents of location & 1060 
can be set by typing 


7A = 100 Giaeiils 
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(Of course, because a location is a single byte, it cannot be set to a 
fractional number, or any integer above 255 decimal, whichis &FF. If this 
is done, the least significant byte is stored in the memory location 
specified.) 


To check the contents of &1600, type 
PRINT 7A [Gat 


BASIC integer variables, such as age%, are stored in four consecutive 
bytes of memory, and four bytes can be accessed using !. 


'A = 76965 Gigi 


Strings can be placed direct in memory, each character’s ASCII code 
being stored in 1 byte of memory. 


$A = "STRING" 


The $ indirection operator appends a carriage return to the end of the 
string, so the above command would give 6 bytes of ASCII code for the 
word ‘STRING’, plus a byte containing &D which is the ASCII code for 


| RETURN 


Notice that the indirection operator is $A, and not A$ which is a BASIC 
string variable. The string in memory can, however, be assigned to a 
BASIC variable: 


name$ = SA [iii 


Another way of using ? is with both a variable and a number. 
A?6 gives the contents of location A+6, in this case location &1996. 
To look at the contents of a group of memory locations, write a small 


program: 


10 FOR I = ® TO 15 
2@ PRINT "CONTENTS OF "SA+I;" ARE “ZA2I 
30 NEXT 


The indirection operators described above are used and explained more 
thoroughly in the chapter on Assembly Language. 


24 User-programmable 
keys 


In the same way that | FUNC! and the alphabetic characters give BASIC 
keywords at a single stroke, you can program the keys marked 1 to @ to 
give any string you choose. 


For example, 


KKEY1 "*CAT™ 


will cause FUNC | 1 to print *CAT on the screen. 


Control characters may be placed in the string, by typing the \ character. 
For example, (419 M is 1M, which performs the same function as the 
[Tanip) key. For a list of control characters, see Appendix A. So, 


*KEY1 “*CAT IM" 


will cause FUNC 1 to print *CAT on the screen, and to set the command 
in operation, Therefore, a whole program, or a series of commands can be 
stored in one key. 


Auseful routine is to have one key which returns the computer to MODE 
6 and lists the program in paged mode: 


*KEY@ "MODE 6 {[M JN LIST |M" 
Here is a key definition containing a small BASIC program: 


*KEY3 "1@ REPEAT !M 20 PRINT CHRSCRND(95)43 
1) !M 36 UNTIL vPOS=24 |M RUN [M" 


For the more advanced 


The EGU key can be programmed also. It takes the value 19. The 
following program cannot be stopped either by | ESCAPE | or EGELG: 


1@ ON ERROR GOTO 30 

20 *KEY1@ “OLD |}M RUN IM" 

30 PRINT “YOU CAN'T STOP ME!" 
40 REPEAT UNTIL FALSE 
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ON ERROR is described in chapter 27. Actually, this program can be 


halted by pressing [agg ELJZUd. 


is called a ‘hard reset’. It resets everything very nearly 
the way it was when the machine was first switched on. When you try it 
you'll hear a beep and you’ll see that the @ reappears after the message 
at the top of the screen. 


[Uit2.L4 on its own is called a ‘soft reset’. It is roughly equivalent to 
pressing [EQQYJ¥ and entering the commands NEW and MODE 6. 


The soft reset does not clear the *KEY definitions for example. 


The five screen editing keys can also be re-defined, just like FUIZL, 
after the issue of a *FX command. 


Keys can also be loaded with the contents of BASIC variables. The 
instruction which does this is OSCLI, which stands for operating system 
command line interpreter. It can be used with any operating system call 
from BASIC (distinguishable by a preceding asterisk), for example, 
*KEY, *SAVE, *LOAD, and so on. Each BASIC variable assigned to the 
KEY definition must be converted into a string, and the asterisk omitted, 
as follows: 


OSCLI "KEY" + STRSX + “LIST [M” 


This will put “LIST iM” into KEY X, where X is a BASIC variable. 


There is no limit to the number of BASIC variables which may be used in 
an OSCLI assignment, provided that they are all either string variables, 
or are turned into strings using STRS$. 


25 BASIC key words 


This chapter contains a description of every word in the Electron BASIC 
language. These words are called ‘keywords’. 


The syntax of each keyword is shown, and an explanation of the form 


used is given below. 


{} 


{1 


<num-const> 
<num-var> 
<numeric > 


<string-const > 


<string-var > 
<string> 


<testable condition> 


<statement> 


<variable name> 


denote possible repetition of the enclosed 
symbols, zero or more times 


enclose optional items 


indicates alternatives from which only one 
should be chosen 


means a numeric constant such as 4.7 or 112 
means a numeric variable such as Y or width 


means either a <num-const> or a <num- 
var>, or a combination of these in an 
expression, like 4*X+1 


means a string enclosed in quotation marks like 
“JONCRAWFORD” 


means a string variable, like A$ or NAME$ 


means either a <string-const> or a <string- 
var>, or an expression such as A$+“ELK” 


means something which is either TRUE or 
FALSE. Since both TRUE and FALSE have values, 
it is possible to use <numeric> instead of 
<testable condition> 


means any BASIC statement, like PRINT or 
GOSUB or PROC 


means any sequence of letters or numbers 
which is an acceptable variable name 
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BASIC keywords 


ABS 


Abbreviation 


Description 


Examples 


Syntax 


ACS 


Abbreviation 


Description 


Examples 


Syntax 


ADVAL 


Abbreviation 


Absolute value 


None FUNCTION 


This function gives the modulus; that is, it strips the 
minus sign from the number variable or expression 
following it. 


PRINT ABS(X) will give 2 if X is -2 
deviation = ABS(Temp1—Temp2) 
root = SQR(ABS(Y)) 


Brackets are optional where sense is not affected. 


<num-var> = ABS (<numeric>) 


Arc-cosine 


None FUNCTION 


This function gives the angle, between @ and PI in 
radians, whose cosine is the number variable or 
expression following ACS. This expression must be 
between —1 and 1 inclusive. 


angle = ACS(@.5) 
course = ACS (-$.789) 
ANGLE = ACS(AD/HY) 


Brackets are optional where sense is not affected. 
<num-var> = ACS (<numeric>) 


SOUND channe! buffer status 


AD. FUNCTION 


Description 


Examples 


Syntax 


AND 


Abbreviation 


Description 


Examples 


Comments 


Syntax 
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Gives number of free spaces in SOUND buffers. ADVAL 
(~5) to ADVAL (-8) correspond to SOUND channels 9 
to 3 respectively. 


X=ADVAL(—7):PRINT’Free spaces in ch. 2= “;X 
IF ADVAL(-5)<>@ THEN SOUND 2,... 


<num-var> = ADVAL(<numeric>) 


Logical AND 


A. OPERATOR 


This is a logical operator which is most commonly used 
inanlIF... THEN statement to combine two conditions 
and obtain a TRUE or FALSE result. 


False AND False gives False 
False AND True gives False 
True AND False gives False 
True AND True gives True 


If this result is TRUE the computer will go on to 

the statement following the THEN. If the result is FALSE 
the computer will go on to the statement following the 
ELSE, but if the ELSE is absent it will go on to the next 
line. 


1F X<.5 AND X>9@ THEN PROCmiddle 
IF Z2= 17 AND Y <7 THEN PRINT “YES” ELSE PRINT 
“NO” 


AND may also be used in the conditional part of a 
REPEAT... UNTIL loop. 


<num-var> = <numeric> AND <numeric> 
<num-var> = <testable condition> AND 
<testable condition> 


136 BASIC keywords 


ASC 


Abbreviation 


Description 


Examples 


Syntax 


ASN 


Abbreviation 


Description 


Examples 


Syntax 


ATN 


Abbreviation 


Description 


Examples 


ASCII code 


None FUNCTION 


This function gives the ASCII character value of the 
first character in the string which follows it. If this 
string is null it gives -1. 


PRINT ASC("JOHN") will give 74 (see ASCII table) 
IF ASC(AS) = 78 THEN NEXT. 
X= ASC("m")*19 


Brackets are optional where sense is not affected. 


<num-var> = ASC (<string>) 


Are-sine 


None FUNCTION 


This function gives the angle, between —PI/2 and P1/2 
in radians, whose sine is the number variable or 
expression following ASN. This expression must be 
between —1 and 1 inclusive. 


PRINT ASN(OP/HY) 
angle = ASN (9.5) 
Brackets are optional where sense is not affected. 


<num-var> = ASN (<numeric>) 


Arc-tangent 


None FUNCTION 


This function gives the angle, between -PI/2 and PI/2 
in radians, whose tangent is the number variable or 
expression following ATN. 


PRINT ATN(OP/AD) 
angle = ATN(—3) 


Syntax 


AUTO 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


BGET# 


Abbreviation 


Description 


Examples 


Syntax 
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Brackets are optional where sense is not affected. 
<num-var> = ATN (<numeric>) 


Automatic line numbering 


AU. or GIG a COMMAND 


This command gets the computer to print the next line 
number and a space each time you press [aiihg. 


The command has two optional parameters: the first is 
the starting line number, and the second is the interval 
between each subsequent line number. The default 
value of both these parameters is 10. 


AUTO 199.5 will give line numbers 169, 105, 110, 115 
etc. 
AUTO by itself will give line numbers 14, 26, 30, 49, 59, 
etc. 


The largest allowable line number is 32767, and the 
largest allowable interval is 255. 


You must press | ESCAPE | to get out of the AUTO mode. 
AUTO|<num-const>{, <num-const>]] 


Read a byte from file 


B.# FUNCTION 


Reads a single byte from a previously opened file 
whose channel number follows (see chapter on file 
handling). 


byte = BGET# channel 
character = BGET#A 


<num-var> = BGET# <num-var> 


138 BASIC keywords 


BPUT# 


Abbreviation 


Description 


Examples 


Syntax 


CALL 


Abbreviation 


Description 


Examples 


Syntax 


CHAIN 


Abbreviation 


Description 


Store a byte to file 


BP.# STATEMENT 
Stores a single byte on a previously opened file whose 
channel number follows (see chapter on file handling). 


BPUT# channel, number 
BPUT# file, Z MOD 256 


BPUT# <num-var>, <numeric> 


Call assembled machine-code subroutine 


CA. STATEMENT 


Used from BASIC to call a previously assembled 
machine-code subroutine. Similar in operation to a 
PROC, being capable of passing parameters. Used in 
preference to a PROC where long calculation is in- 
volved, and speed is at a premium. 


39 CALL &2999 


79 fraction = &16A5 
89 CALL fraction 


15 CALL fraction, string$, number, integer’, ?byte 


CALL <numeric>{,<num-var> | <string-var>} 


Load and run a program 


CH. or GTA K STATEMENT 


An instruction which LOADs and RUNs the program 
whose title is in the quotes. If the title is omitted the 
next program on the tape will be loaded. Can be used 
in one program to load another. NB all variables 
except the resident integer variables are cleared. 


Examples 


Syntax 


CHR$ 


Abbreviation 


Description 


Examples 


Syntax 


CLEAR 


Abbreviation 


Description 


Examples 


Syntax 


CLG 


Abbreviation 
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CHAIN “PROG1” 
CHAIN "” 


CHAIN <string> 


Character code 


CHR. FUNCTION 


Gives the character whose ASCII code is the number 
variable or expression following CHRS. 


PRINT CHRS(32) 
AS = AS + CHRS(code%) 


Brackets are optional where sense is not affected. 


<string-var> = CHR$ (<numeric>) 


Clear memory 


CL. STATEMENT 
This instruction takes away all the variable names in 
use, except the resident integer variables A&% to Z%, 
and @%. 

IF FNcrash > 39 THEN CLEAR 


CLEAR 


Clear graphics screen 


None STATEMENT 
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Description 


Examples 


Comments 


Syntax 


CLOSE# 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


CLS 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


Fills the graphics screen with current graphics back- 
ground colour (which can be altered by the GCOL 
instruction). The graphics cursor is ‘homed’ to 0,0 
bottom left of graphics screen. 


IF X THEN CLG 


fHii§ P has same effect. 
CLG 


Close a file 


CLO. # STATEMENT 


Tells the computer you have completely finished with 
the file whose channel number follows (see chapter on 
file handling). 


CLOSE # (Channel) 
CLOSE# file1 


CLOSE# closes all files. 
CLOSE# <numeric> 


Clear text screen 


None STATEMENT 


Fills text screen with current text background colour 
(which can be altered by the COLOUR instruction), The 
text cursor is homed to @,@ the top left of the text 
screen. 


iF X THEN CLS 


aul L has same effect. 
cLs 


COLOUR 


Abbreviation 


Description 


Examples 
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c. or GI c STATEMENT 


Used to select text screen foreground and background 
colour. 


Standard colours, with their logical values, in each 
mode are as follows: 


Foreground colour Background colour 


Logical no Actual colour Logical no Actual colour 
Modes 9,3,4,6 

9 Black (@) 128 Black (#) 

1 White (7) 129 White (7) 


Modes 1,5 


Black (@) 128 Black () 
Red (1) 129 Red (1) 
Yellow (3) Yellow (3) 


White (7) White (7) 


Black (4) Black (#) 
1 Red (1) 129 Red (1) 
2 Green (2) 136 Green (2) 
3 Yellow (3) 131 Yellow (3) 
4 Blue (4) 132 Blue (4) 
5 Magenta (5) 133 Magenta (5} 
6 Cyan (6) 134 Cyan (6) 
7 White (7) 135 White (7) 
8 Flashing black/white (8) 136 Flashing black/white (8) 


9 Flashing red/cyan (9) 
1@ Flashing green/magenta (16) 
11 Flashing yellow/blue (11) 
12 Flashing blue/yellow (12) 
13 Flashing magenta/green (13) 
14 Flashing cyan/red (14) 
15 Flashing white/black (15) 


137 Flashing red/cyan (9) 

138 Flashing green/magenta (1) 
139 Flashing yellow/blue (11) 
140 Flashing blue/yellow (12) 
141 Flashing magenta/green (13) 
142 Flashing cyan/red (14) 

143 Flashing white/black (15) 


COLOUR takes one parameter, which is the logical 
value of the particular colour required, as given in the 
tables. 

COLOUR 2 


COLOUR 131 
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Comments 


Syntax 


Cos 


Abbreviation 


Description 


Examples 


Syntax 


COUNT 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


Colours used in each mode may be changed using 
VDU1S;. 


See chapter 26 
COLOUR <numeric> 


Cosine 


None FUNCTION 


This function gives the cosine of an angle, which must 
be in radians. 


PRINT COS(3.142) 

X= COS(y) 

Brackets are optional where sense is not affected. 
<num-var> = COS (<numeric>) 


Count characters 


cou. FUNCTION 


Counts the number of characters printed using PRINT 
since last carriage return. 


1@ PRINT “Happy Birthday “; COUNT 
29 PRINT “Happy” ' “Birthday “; COUNT 
>RUN 

Happy Birthday 15 

Happy 

Birthday 9 


Different from POS, which gives the position of the 
cursor from the left hand margin. 


<num-var> = COUNT 


DATA 


Abbreviation 


Description 


Examples 


Syntax 


DEF 


Abbreviation 


Description 


Examples 


Syntax 


DEG 


Abbreviation 


Description 


Examples 
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Data in program 


D. STATEMENT 


This enables you to store information in a program and 
to recall it using a READ instruction. The information 
can be string or numeric. (See chapter on READ and 
DATA). 


19 READ A,BS,century 
26 DATA 3,GEORGE,18 


DATA <str-const> |<num-const> |<num-var>{, 
<str-const> |<num-const> |<num-var>} 


Define function or procedure 


None STATEMENT 


Informs the computer that an FN or PROC is about to 
be defined. (See chapters on procedures and functions.) 


19 DEF FNdouble(X) = X*2 
19 DEF PROCdouble 

29X = X*2 

39 ENDPROC 


DEF FN! PROC <name>|(<string-var> | 
<num-var>{, <string-var>| <num-var>})] 


Degrees 


GO x FUNCTION 


Converts radians into degrees. 


angle = DEG(PI/6) 
angle = DEG(ACS(§.78)) 
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Syntax 


DELETE 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


DIM 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


Brackets are optional where sense is not affected. 


<num-var> = DEG<numeric> 


Delete program lines 


DEL. COMMAND 


This command will delete a section of program from 
the first line number stated to the second inclusive. 
Cannot be used in a program. 


DELETE 199,159 


To delete a single line, just type the line number and 
press GiGi. 


DELETE <num-const>,<num-const> 


Dimension of an array 


None STATEMENT 


Informs the computer of how much memory to reserve 
for a named array. (See chapter on arrays.) 


DIM Date$ (12,31) 
DIM X(199) 


DIM is also used to allocate space for machine-code 
programs. 


DIM <num-var>|<str-var> 
(<numeric>{,<numeric>}) 
DIM <num-var> <numeric> 


DIV 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


DRAW 


Abbreviation 


Description 


Examples 


Syntax 


BASIC keywords 145 


Integer division 


None OPERATOR 


This tells the computer to divide one number into 
another using integer arithmetic; this means the result 
will always be a whole number. 


17 DIV 2 gives 8, ie the number of times that 2 can be 
subtracted from 17 with a positive or zero remainder. 


If numbers or variables are used which are not 
integers, then they will be truncated before the div- 
ision is carried out. 


8.1 DIV 2.9 gives 4. 


<num-var> = <numeric> DIV <numeric> 


Draw line on screen 


DR. or D STATEMENT 


Will draw a line from the previous coordinates of the 
graphics cursor to the new ones given, in all graphics 
modes (9, 1, 2, 4 and 5). To move the graphics cursor 
use the MOVE instruction. 

The screen is always § to 1279 on the X axis and @ to 
1924 on the Y axis, regardless of which graphics mode 
you are in. The line is drawn in the current graphics 
foreground colour which can be changed by using the 
GCOL instruction. 


16 MODE 4 
29 MOVE @, 512 
39 DRAW 1279, 512 


will draw a horizontal line half way up the screen. 
See chapter 29 
DRAW <numeric>, <numeric> 
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ELSE 


Abbreviation 


Description 


Examples 


Syntax 


END 


Abbreviation 


Description 


Examples 


Syntax 


ENDPROC 


Abbreviation 


Description 


Examples 


Syntax 


EL. or | FUNC} E (See IF) 


Used to provide an alternative course of action if the 
result of an IF statement is false. 


iF A= 9 THEN PRINT “YES” ELSE PRINT “NO” 
IF B THEN 199 ELSE 299 


{F <testable condition> THEN <statement> 
ELSE <statement > 


None STATEMENT 
Can be used to halt execution of a program. Its other 
use is to reset TOP after a PAGE move. 


PAGE = &1699 : END 
69 IF finished THEN END 


END 


End of procedure 


E. STATEMENT 


This statement must conclude a DEF PROC as it tells 
the computer you have finished defining the pro- 
cedure. 


199 DEF PROCname 
119 REM statement 
129 REM statement 
139 ENDPROC 


ENDPROC 
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ENVELOPE 
Abbreviation ENV. STATEMENT 
Description This statement is used in conjunction with the SOUND 


Syntax 


statement to control the pitch of a sound. The ENV- 
ELOPE statement is followed by 14 parameters. 


ENVELOPE n,s,Pi1,Pi2,Pi3,Pr1,Pr2,Pr3,126,0,0,-126, 
126,126 
Parameter Range Effect 


n 1to4 Envelope number 
bits 9-6 §to 127 Length of each step in 
1/190 of a second 


s bit 7 Gorl § = auto-repeat the 
envelope 
1=no auto-repeat 

Pil —128 to 127 Change in pitch per step in 
section 1 

Pi2 —128 to 127 Change in pitch per step in 
section 2 

Pi3 —128 to 127 Change in pitch per step in 
section 3 

Pri to 255 Number of steps in section 
1 

Pr2 @ to 255 Number of steps in section 
2 

Pr3 @ to 255 Number of steps in section 
3 


See chapter 22 


ENVELOPE <num-var>,<num-var>, <num-var>, 
<num-var>, <num-var>, <num-var>, <num-var>, 
<num-var>, <num-var>, <num-var>, <num-var>, 
<num-var>, <num-var>, <num-var> 
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EOF# 


Abbreviation 


Description 


Examples 


Syntax 


EOR 


Abbreviation 


Description 


Examples 


Syntax 


End of file check 


None FUNCTION 


This function is used to discover whether the end of an 
open file has been reached. The function gives a —1 if 
the end has been reached and a 6 if not, EOF# must be 
followed by the channel number. 


IF EOF# (channel) THEN PROCclose 
REPEAT... :UNTIL EOF# (X). 


<num-var> = EOF# (<num-var>) 


Logical exclusive-OR 


None OPERATOR 
This is used in an IF... THEN or REPEAT... UNTIL 
loop to combine two conditions in the following way: 


False EOR False gives False 
False EQR True gives True 
True EOR False gives True 
True EOR True gives False 


In other words, if the results of the two conditions 
combined by an EOR are different then the result is 
true. 


IF A=6 EOR B< 19 THEN GOSUB 429 


<num-var> = <numeric> EOR <numeric> 


EQUB 


Abbreviation 


Description 


Examples 


Syntax 


EQUD 


Abbreviation 


Description 


Examples 


Syntax 


EQUS 


Abbreviation 


Description 
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None STATEMENT 


Used to insert a byte of data into an Assembly 
Language program. EQUB can only be used inside the 
square brackets enclosing a piece of Assembly Lan- 
guage. 


EQUB 13 
EQUB A% 


EQUB <numeric> 


None STATEMENT 


Used to insert a double-word (4 bytes) of data into an 
Assembly Language program. EQUD can only be used 
inside the square brackets enclosing a piece of Assem- 
bly Language. 


EQUD 19999080 
EQUD F% 


EQUD <numeric> 


None STATEMENT 


Used to insert the ASCII values of a string into an 
Assembly Language program. EQUS can only be used 
inside the square brackets enclosing a piece of Assem- 
bly Language. 
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Examples 


Comments 


Syntax 


EQUW 


Abbreviation 


Description 


Examples 


Syntax 


ERL 


Abbreviation 


Description 
Examples 


Syntax 


EQUS “Too big” 
EQusS LS 


Used, among other things, for printing error messages 
in Assembly Language programs. Unlike the indirect- 
ion operator $, EQUS does not adda (&D) to 
the end of the string. 


EQUS <string> 


None STATEMENT 


Used to insert a word of data (2 bytes) into an 
Assembly Language program. EQUW can only be used 
inside the square brackets enclosing a piece of Assem- 
bly Language. 


EQUW &FFEG 
EQUW Z% 


EQUW <numeric> 


Error line number 


None FUNCTION 


A function which gives the line number in which the 
last error occurred. 


X= ERL 
REPORT: PRINT ” at line “;ERL 


<num-var> = ERL 


ERR 


Abbreviation 


Description 


Examples 


Syntax 


EVAL 


Abbreviation 


Description 


Examples 


Syntax 


EXP 


Abbreviation 


Description 


Examples 


Syntax 


EXT# 
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Error 


None FUNCTION 


A function which gives the numeric code for the last 
error which occurred. This is useful for error trapping. 


IF ERR = 17 THEN CLOSE# (channel) 


<num-var> = ERR 


Evaluate 


EV. FUNCTION 


Mainly used to enable you to type an expression, such 
as a mathematical equation, into the computer while a 
program is running. The equation is entered as a string, 
eg AS = “COS(X/29)", and EVAL(AS) will work it out. 


AS = "COS(X/29)” 
Y = EVAL(AS) 


<num-var> = EVAL (<string>) 
<str-var> = EVAL (<string>) 


Exponent 


None FUNCTION 


This mathematical function calculates the exponential 
e (2.7183 . . .) raised to any specified power. 


Y = EXP(X) 
ie Y = e to the power of X 


<num-var> = EXP (<numeric>) 


Reserved for future use. 
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FALSE 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


FN 


Abbreviation 


Description 


Examples 


Syntax 


FA. CONSTANT 


This is a condition which the computer understands to 
be the number @. If the computer decides a certain 
condition is false it will represent it as $, and will act 
accordingly. 


REPEAT... :UNTIL FALSE 
IF A= FALSE THEN... 


PRINT 1=2 


gives 0, because 1 is not equal to 2, and so 1=2 is 


FALSE. 
<num-var> = FALSE 


User-definable function 


None Prefix 


FN is a prefix that identifies a function, both in a DEF 
statement and in a function call. 


1p INPUT A 

29 answer = FNsquare(A) 

39 PRINT answer 

49 END 

59 DEF FNsquare(number) = number*number 


DEF FNe = 2.7182818. 


DEF FN <name> {(<num-var>| <str-var>{, 
<num-var>| <str-var>})] 


po 


FOR 


Abbreviation 


Description 


Syntax 


GCOL 


Abbreviation 


Description 
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F. STATEMENT 


FOR is used to initiate the control variable of the 
FOR... NEXT loop and will always take the following 
format: 


FOR — (number or TO STEP 
(numeric variable) numeric variable) (n or nv) (n or nv) 
control variable start parameter finish increment 
parameter 


Tf the STEP is omitted it is assumed to be 1. 


When executing a FOR... NEXT loop the computer 
sets the control variable to the start parameter. 


Each time NEXT is encountered the computer increm- 
ents the control variable and loops back to the 
instruction just after FOR. This is repeated until the 
control variable is greater than the finish parameter. 
NB the increment can be negative. 


FOR <num-var> = <numeric> TO <numeric> 
{STEP <numeric>] 


Graphics colour 


GC. STATEMENT 


Used to select graphics screen foreground and back- 
ground colour, and to control effect of mixing colours. 
Takes two parameters, the second being the logical 
value of the colour required, the first the way in which 
two colours mix. 


Action of first parameter is as follows: 


9 Plot the colour specified 
1 OR the colour specified with those already on the 
screen 
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Examples 


Comments 


Syntax 


2 AND the colour specified with those already on the 
screen 

3 EOR the colour specified with those already on the 
screen 

4 Plot the logical inverse of the colour specified 


This mixing is carried out on a bit by bit basis. For 1, 2, 
and 3, each binary digit in the plotted colour’s logical 
value is ORed, ANDed, or EORed with its respective 
digit in the screen colour’s logical value, to produce the 
logical colour which is to be plotted on that part of the 
screen. 


Inversion, 4, only involves the plotted colour, all its 
binary digits being inverted. In bit by bit logic, @ is 
false and 1 is true. 


The truth tables for OR, AND, and EOR are as 
follows: 


OR @ gives 9 
®@OR 1 gives 1 
1OR @ gives 1 
10OR 1 gives 1 
§ AND 1 gives 6 
@ AND @ gives @ 


1 AND @ gives @ 
1 AND 1 gives 1 


@ EOR @ gives @ 
9 EOR 1 gives 1 
1 EOR @ gives 1 
1 EOR 1 gives 


GCOL 2, 1 
GCOL RND(5)-1, RND(8)—1 
GCOL, mix%, 129 


Colours used in each mode may be changed using 
vou19; 

See chapter 26 

GCOL <numeric>, <numeric> 


GET 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


GET$ 
Abbreviation 


Description 


Examples 


Syntax 


GOSUB 


Abbreviation 


Description 


BASIC keywords 155 


Get code from keyboard 


None FUNCTION 


This instruction causes the computer to read a char- 
acter from the keyboard buffer. If there is none, the 
computer will wait for a key to be pressed. It then gives 
the ASCII code for that key (see ASCII table) before 
continuing. 


Key = GET 


The keyboard buffer may be flushed by *EX15. 
<num-var> = GET 


Get character from keyboard 


GE. FUNCTION 
This instruction is the same as GET, but gives a string 
containing the character before continuing. 


Key$ = GETS 


<string-var> = GETS 


Go to a subroutine 


GOS. STATEMENT 


This instruction tells the computer to go to a sub- 
routine and start executing instructions from the 
specified line number until the instruction RETURN, 
when the computer must return to the instruction 
immediately after the GOSUB call. No more than 26 
nested subroutines are allowed. 
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Examples 


Comments 


Syntax 


GOTO 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


HIMEM 


Abbreviation 


Description 


GOSUB 1999 
ON A GOSUB 19, 29, 39 


It is possible to use an expression, and brackets must 
then be used: 


GOSUB (19*A) 


but this will not work if the program is RENUMBERed. 
GOSUB <numeric> 


Go to a line number 


G. or FTG c STATEMENT 


This instruction tells the computer to jump to the 
specified line number and start executing instructions 
there. 


GOTO 199 
ON A GOTO 16, 29, 39 


It is possible to use an expression: 
GOTO (19*A) 


but this will not work if the program is RENUMBERed. 
GOTO <numeric> 


H. VARIABLE 


Address pointer containing the address of the lowest 
location in memory used by the screen display. Its 
value may change depending upon which mode you are 


Examples 


Syntax 


IF 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


INKEY 


Abbreviation 


Description 


) 
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using. No BASIC instructions or variables are stored 
above this point. HIMEM can be altered by the user, to 
preserve space for machine-code programs between 
BASIC and the screen. HIMEM contains the highest 
memory location that BASIC may use. This may be 
changed after a MODE statement. 


PRINT HIMEM 
HIMEM = &4999 


<num-var> = HIMEM 


Conditional IF 


None STATEMENT 


A word forming part of the IF... THEN... ELSE state- 
ment. IF must always be followed by a testable 
condition, and the result of this test (TRUE or FALSE) 
will control the subsequent action by the computer. 


IF A<5 THEN... 
IF 10 > 149 THEN PRINT “GENIUS” 


iF A THEN 119 
means 


IF A<> §@ THEN GOTO 119 


If <testable condition> THEN <statement> 
IF <testable condition> THEN <line number> 
[ELSE <statement> |<line number>] 


None FUNCTION 


This instruction will wait a specified length of time for 
a key to be pressed before continuing. If a key is 
pressed its ASCII code is given but if no key is pressed 
a—1 is given. The number in brackets is the time delay 
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Examples 


Comments 


Description 


Gi) 


Examples 


measured in 1/19 sec, and can have any value 
between § and 32767. 


key = INKEY(199) 


In fact, this instruction and GET, GETS, and INKEY$ will 
actually test the keyboard buffer. This means that an 
INKEY instruction will respond to any previously 
pressed key whose code has gone into this buffer 
(memory), even if you are not pressing it at this 
moment. 


To get over this problem the keyboard buffer can be 
flushed using a *FX15,1 instruction just before using 
INKEY. Also, the autorepeat can be turned off by using 
*FX11,9. 


In addition to the above, the INKEY instruction can be 
used to test for a single key directly. Using a negative 
number in the brackets, one for each key according to 
the table shown below, INKEY gives —1 if the key is 
pressed, @ if it is not. INKEY used in this way does not 
read the buffer — it reads the key itself. See the table 
which follows. 


IF INKEY(—99) THEN... 
will be TRUE when the space-bar is pressed. 


Brackets are optional where sense is not affected. 


ta 


ey Number 
—66 
—161 
—83 
—51 
—35 
—68 
—84 
—85 
—38 
—76 
—71 
—87 
—162 
—86 
—55 
—56 
—17 
—52 
—82 
—36 
—54 
—100 
—34 
—67 
—69 
—98 


NKM ES CHMDOVOZEOROMTOVAOOWS 
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Key Number 
—49 
59 
18 
—19 
—26 
—53 
—37 
=22 
—39 
—46 
—24 
—88 
—713 
, —193 
; —104 


leo mnnanrhwnere 


/ —195 
SPACE BAR —99 
-113 

CAPS LK —65 

CTRL —2 

SHIFT -1 

DELETE —9 

COPY —196 

RETURN —74 

4 —58 
{ —42 
as —26 
ae —122 


Syntax <num-var> = INKEY(<numeric>) 
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INKEY$ 


Abbreviation 


Description 


Examples 


Syntax 


INPUT 


Abbreviation 


Description 


Examples 


Syntax 


INPUT# 


Abbreviation 


Description 


INK. FUNCTION 
The same as INKEY but gives the key as a character. 


KeyS = INKEYS (199) 
Brackets are optional where sense is not affected. 


<string-var> = INKEY(<numeric>) 


1. or G1 STATEMENT 


This instruction halts the program, prints a ? on the 
screen, and waits for some information to be entered 


followed by | RETURN fl 
INPUT must be followed by a variable. 


INPUT X 
INPUT nameS, number 


Too complex for a simple description. 


Input from file 


L# STATEMENT 


INPUT# is like INPUT, but instead of receiving 
information from the keyboard the computer takes it 
from a previously opened file. Must be followed by 
channel number (see chapter on file handling). 


Examples 


Syntax 


INSTR 


Abbreviation 


Description 


Examples 


Syntax 


INT 


Abbreviation 


Description 
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INPUT# channel, makeS, price 
INPUT# C,B,A,ZS$ 


INPUT# <num-var>, <num-var>|<string-var> 
{, <num-var>|<string-var>} 


In string 


INS. Includes ( FUNCTION 


This function will give the position of one string within 
another, the leftmost character position being 1. The 
search normally starts from the beginning of the string 
but an optional third parameter provides the facility to 
start the search from any specific character position. 
The number given by INSTR is the position of the 
second string within the first. A search for a null string 
(”) will always give 1. If the search fails (the two 
strings are not the same at any position) then (is given. 


position = INSTR(first$, second$, start) 
PRINT INSTR(“MONOTONOUS”,”ON") 
will print 2, whereas 

PRINT INSTR(” MONOTONOUS”,”0N",3) 
will print 6 


<num-var> = INSTR(<string>, <string> 
|,<numeric>]) 


Integer part 


None FUNCTION 


This function returns the next whole number below 
the value of the number variable or expression in 
brackets. In other words the number is truncated. 
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Examples 


Syntax 


LEFT$ 


Abbreviation 


Description 


Examples 


Syntax 


LEN 


Abbreviation 


Description 


Examples 


Syntax 


INT(1.7) is 1 
INT(-1.7) is —2. 
x= INT(Y) 


Brackets are optional where sense is not affected. 


<num-var> = INT <numeric> 


Left string 


LE. Includes { FUNCTION 


A function which gives the specified number of leftmost 
characters in a string. 


PRINT LEFTS("ELECTRON”,5) 
will give ELECT 


AS = LEFTS(BS,C) 


<string-var> = LEFT$(<string>, <numeric>) 


Length of string 


None FUNCTION 
A function which gives the number of characters 
(including spaces) in the specified string. 

PRINT LEN("Donald Duck’) 

will be 11 

Length = LEN (AS) 

Brackets are optional where sense is not affected. 
<num-var> = LEN(<string>) 


LET 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


LIST 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


BASIC keywords 163 


None STATEMENT 


This is an optional keyword which is used to assign a 
value to a variable. 


LET X=1@ has same effect as X= 19 
LET AS = "JOHN" has same effect as A$ = "JOHN" 


May not be used with LOMEM, HIMEM, PAGE and 
TIME. 


LET <var> = <expression> 


L or GIL COMMAND 


This command instructs the computer to list the 
current program on the screen. It has two optional 
parameters which control the first and last lines to be 
listed. 


LIST 199,209 will list from 199 to 208 
LIST ,299 will list up to 209 
LIST 199, will list from 199 


Since LIST is a command it cannot be used in a 
program or in a multi-statement line. 


If you press N beforehand, LIST will list your 
program a screen-full at a time, When you want to see 
the next screen-full, press | SHIFT F This paged mode 
can be cancelled using [WQqq O. 


LIST|<num-const>|,|<num-const>] 
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LISTO 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


LN 


Abbreviation 


Description 


Examples 


Syntax 


List option 


None COMMAND 


This command must be followed by a number which 
controls the way in which a program is LI$Ted, as 
follows: 


§ List just as stored in computer’s memory 
1 Insert a space after each line number 

2 Indent FOR... NEXT loops 

4 Indent REPEAT... UNTIL loops 


Any combination of the above may be obtained by 
adding the required values. 


LISTOS will insert a space after the line number and 
indent REPEAT... UNTIL loops. 


Since LISTO is a command it cannot be used in a 
program or in a multi-statement line. 


LISTO <num-const> 


Natural logarithm 


None FUNCTION 


A mathematical function to calculate the natural 
logarithm of the given number variable or expression. 


X=LN{Y) 
Brackets are optional where sense is not affected. 


<num-var> = LN<numeric> 


LOAD 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


LOCAL 


Abbreviation 


Description 


Examples 


Syntax 
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Load program from file 


Lo. or GI . COMMAND 


A command which instructs the computer to LOAD the 
named program from the file. If the name is omitted 
then the next program is loaded. 


When the computer prints ‘Loading’ on the screen, the 
old program has been deleted and all variables cleared 
except the resident integer variables. 


LOAD “BUGZAP!" 
LOAD “” loads the next program (from tape only) 


During LOADing, the computer prints up the number of 
pages of memory being used. 
LOAD<string> 


Variable declaration 


Loc. or HY a STATEMENT 


Informs the computer that the named variables are 
LOCAL to the PROC or FN in which they are declared. 


LOCAL variables are totally independent of variables 
with the same name outside the PROC or FN. 


LOCAL | 
LOCAL price% 


LOCAL<string-var>| <num-var>{,< string-var>l 
<num-var>} 
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LOG 


Abbreviation 


Description 


Examples 


Syntax 


LOMEM 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


MID$ 


Abbreviation 


Description 


Common logarithm 


None FUNCTION 
A mathematical function to calculate the common 
logarithm of the given number variable or expression, 


Y = LOG(X) 
rate = LOG(cone) 


<num-var> = LOG<numeric> 


LOM. VARIABLE 


Address pointer containing the address above which 
all the BASIC program’s variables are stored. It is 
usually set to be the same as TOP, but can be altered by 
the user at the start of a program. 


PRINT LOMEM 
@ LOMEM = &FA2 


If LOMEM is changed during program execution the 
computer will lose all its BASIC variables. 


LOMEM = <numeric> 
<num-var> = LOMEM 


Middle string 


M. Includes ( FUNCTION 


This function gives a subsection of a string; the 
position of the first character of the substring and the 
number of characters being specified. If the length is 


Examples 


Syntax 


MOD 


Abbreviation 


Description 


Examples 


Comments 


Syntax 
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omitted, the whole string to the right of the start 
position is given. 
PRINT MIDS$(MainS, start, length) 


PRINT MIDS$("MICROCOMPUTER’,6,7) 
will be COMPUTE 


PRINT MID$("MICROCOMPUTER”,6) 
will be COMPUTER 


X$ = MIDS(AS,S,L) 


<string var> = MID$(<string>,<numeric> 
[,<numeric>]) 


Modulo 


None OPERATOR 


This function gives the remainder when an integer 
division is carried out. 


§ MOD 2 is 1 
55 MOD 5 is @ 
—19 MOD 4 is —2 
numerator’ MOD denominator’ 


Tf this function is used with decimal numbers or 
variables, these values are truncated before the divi- 
sion takes place. 


4.1 MOD 3.9 is 1. 


<num-var> = <numeric> MOD<numeric> 
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MODE 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


MOVE 


Abbreviation 


Description 


Examples 


Graphics mode 


MO. or TT] M STATEMENT 


Here is a list of the seven modes and their character- 
istics: 


Mode Graphics Colours Text 

1] 649X 256 2 80X32 
1 326X256 4 49X32 
2 166X256 16 29X32 
3 Text only 2 80X25 
4 329X256 2 49X32 
5 166X256 4 20X32 
6 Text only 2 40X25 


This instruction tells the computer to change screen 
mode. Changing mode clears the screen and must not 
be used within a PROC or FN. MODE resets the value of 
HIMEM. 


MODE @ 
MODE x 
19 MODE mode 


Text coordinates change from mode to mode, but 
graphics coordinates are scaled to be the same in all 
graphics modes: 9 to 1279, @ to 1923. 


MODE <numeric> 


Move graphics cursor 


MOV. STATEMENT 


This instruction moves the graphics cursor to any 
position, on or off the screen. 


MOVE 649, 512 
19 MOVE X,Y 


Comments 


Syntax 


NEW 


Abbreviation 


Description 


Examples 


Syntax 


NEXT 


Abbreviation 


Description 


Examples 


Syntax 
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The graphics origin may be moved to any position on 
or off the screen by using the instruction 


VDU239,X;Y; 

where X,Y are the coordinates you wish to become 9,9. 
See chapter 20 

MOVE <numeric>,<numeric> 


New program 


None COMMAND 


“This command deletes a program from the computer's 


memory by adjusting certain internal pointers. A 
program can be retrieved by typing OLD which resets 
the internal pointers, provided no new program lines 
have been entered and no new variables have been 
created. Since it is a command it cannot be used ina 
program or multi-statement line. 


NEW 


NEW 


N. or GT N STATEMENT 


This is used to step the control variable ina FOR... 
NEXT loop. The control variable after the NEXT is 
optional (see FOR). 


NEXT X% 
NEXT loop 
NEXT 


NEXT [<num-var>] {, <num-var>} 
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NOT 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


OLD 


Abbreviation 


Description 


Examples 


Syntax 


Logical NOT 


None FUNCTION 


Normally used in conjunction with a testable condition 
to reverse the logic of the result, ie TRUE becomes 
FALSE and FALSE becomes TRUE. 


IF NOT(A=5) THEN money = 79. 


TRUE and FALSE are represented as —1 and  respect- 
ively, 


NOT# is —1, NOT—1 is 9. 


Beware of trying to use NOT with other values for 
TRUE. NOT1 is -2, which still acts as TRUE. 


<num-var> = NOT <numeric> 
<testable condition> = NOT (<testable condition>) 


Old program 
0. or GURY 0 (includes FETE) comMManpd 


This command is used to recover a program which has 
recently been deleted by NEW, or by pressing the 


key, or | BREAK F 


OLD 
OLD 


ON 


Abbreviation 


Description 


Comments 
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None STATEMENT 


This instruction can be used in conjunction with GOTO, 


GOSUB and ERROR. 
Firstly GOTO and GOSUB. 


ON X GOTO 199, 389, 359, 478 


If X=1 then the program will go to 199. If X=2 then it 
will go to 309. If X=3 then it will go to 35@ and so on. 


ON X GOSUB 475, 295, 319 

If X=1 then the program will ‘gosub’ 475. If X=2 it will 
‘gosub’ 205 and so on. 

An ELSE can be included at the end to trap out of range 
values without causing an error. 

ON X GOTO 7, 196, 319 ELSE ENDPROC 

Secondly ERROR 


ON ERROR GOTO 1999 
ON ERROR RUN 
ON ERROR PROCerror 


This instruction is used for error trapping. This 
enables the program to deal with errors, rather than 
letting the computer halt the program and print up an 
error message. 


Errors may be accepted once again by typing 


ON ERROR OFF 


when the computer will halt and print messages as 
usual. 
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Syntax 


OPENIN 


Abbreviation 


Description 


Examples 


Syntax 


OPENOUT 


Abbreviation 


Description 


Examples 


Syntax 


ON <num-var> GOTO <numeric>{,<numeric>} 
or 
ON <num-var> GOSUB <numeric>{,<numeric>} 


or 
ON ERROR <statement> 
or 


ON ERROR OFF 


Open input file 


OP. FUNCTION 


This function opens a file from the current filing 
system, eg cassette to the computer and returns the 
channel number allocated by the computer’s file 
system. If the file does not exist then a @ (FALSE) is 
returned. The file is opened for input only. See chapter 
on file handling. 


file = OPENIN “SCREENLOAD” 
X = OPENIN AS 


<num-var> = OPENIN (<string>) 


Open output file 


OPENO. FUNCTION 


This function opens a file from the computer to the 
current filing system, eg cassette and returns the 
channel number allocated by the computer's file 
system. If the file does not exist then one will be 
created. Ifa file of the same name already exists then it 
will be deleted and a new one created. The file is 
opened for output only. 


file = OPENOUT “SCREENDUMP” 
= OPENOUT AS 


<num-var> = OPENOUT(<string>) 


OPENUP 


Abbreviation 


Description 


Examples 


Syntax 


OPT 


Abbreviation 


Description 


Examples 
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Open file for update 


None FUNCTION 


This function opens a file from the current filing 
system, eg cassette to the computer, in the same way 
as OPENIN. The file is opened for input and output. 


edit = OPENUP “Accounts” 
Z = OPENUP name$ 


<num-var> = OPENUP(<string>) 


Assembly option 


None STATEMENT 


Used to select whether error messages are reported, or 
listings are given during assembly of a machine-code 
subroutine. OPT can only be used inside the square 
brackets enclosing a piece of Assembly Language. 


It may take eight different values of parameter: 


OPT @ Report no errors, list no machine-code 
OPT 1 Report no errors, list the machine-code 
OPT 2 Report any errors, list no machine-code 
OPT 3 Report any errors, list the machine-code 


OPT 4 to OPT 7 are the same as OPTs 9 to 3 except that 
the machine-code is generated at the origin O% 
instead of the program counter P%. 


59 OPT 2 

199 For | = @ TO 3 STEP 3 
119 [OPT 1 

129.... 

139....] 

149 NEXT 
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Comments 


Syntax 


OR 


Abbreviation 


Description 


Examples 


Syntax 


OSCLI 


Abbreviation 


Description 


Examples 


The second example above is commonly used in two- 
pass assembly, which will always give errors on the 
first pass. 


OPT <numeric> 


Logical OR 


None OPERATOR 


This is a logical operator which combines two testable 
conditions in the following way: 


False OR False gives False 
False OR True gives True 
True OR False gives True 
True OR True gives True 


IFA= 5 ORA=19 THEN... 
IF Altitude OR B% THEN... 
IF X < 2 OR NOT(Y=4) THEN... 


<num-var> = <numeric> OR <numeric> 


Operating system command line interpreter 


os. STATEMENT 


Used to pass BASIC variables as parameters to 
operating system calls, such as *FX or *KEY. Must be 
used with a string, the variables being converted using 
STRS. The complete string must be the same as would 
be used normally, but without the asterisk. 


OSCLI“FX"-+STRS action+",”+STR$ parameter 
OSCLI“KEY"+STR$ keynumber+keystring$ 


PAGE 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


PI 


Abbreviation 


Description 


Examples 


Syntax 
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PA. VARIABLE 


Address pointer containing the address above which 
the BASIC program is stored. It is usually set to EGG 
on cassette only machines, but can be altered by the 
user to locate more than one BASIC program in 
memory. 


PRINT PAGE 
PAGE = & 1699 


The two least significant hex digits of PAGE are always 
zero — it points to the base of a page of memory, which 
always contains 256 bytes. 


PAGE = < numeric> 
<num-var> = PAGE 


None CONSTANT 


PI has the value 3.14159265 and can be used just like a 
number. 


circumference = 2*P{*radius 
area = PI*radius A2 


<num-var> = Pl 
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PLOT 


Abbreviation 


Description 


Plot graphics 


PL. or FiTg P STATEMENT 


The PLOT instruction is used to draw single points, 
lines, dotted lines and triangles. 


PLOT takes the form: 
PLOT A,X, Y 


which will plot at or to the point X,Y in the manner 
determined by the value of the first parameter A. 


The effect of the value of the first parameter is: 
% Move relative to last point. 


1 Draw line relative in the current graphics fore- 
ground colour. 


2 Draw line relative in the logical inverse colour. 


3 Draw line relative in current graphics background 
colour. 


4 Move to absolute position. 


5 Draw line absolute in the current graphics fore- 
ground colour. 


6 Draw line absolute in logical inverse colour. 


7 Draw line absolute in current graphics background 
colour. 


Higher values of A have other effects which are related 
to the effects given by the values @ to 7 


8-15 As §-7 but with the last point in the line omitted 
in ‘inverting actions’ — eg using GCOL4. 


16-23 As §-7 but with a dotted line. 


24-31 As §-7 but with a dotted line and without the 
last point on the line. 


32-63 Are reserved for the Graphics Extension ROM. 
64-71 As 9-7 but only a single point is plotted. 


Syntax 


POINT 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


POS 


Abbreviation 


Description 


Examples 


Syntax 
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72-79 Line fill. 


89-87 As @-7 but plot and fill a triangle. When filling 
solid triangles with colour the computer fills the 
triangle between the coordinates given and the last 
two points visited. 


88-95 Line fill. 
See chapter 26 


PLOT <numeric>, <numeric>, <numeric> 


Point at graphics screen colour position 


PO. FUNCTION 


This function gives the logical colour at the specified 
point on the screen. If this point is off the screen then a 
-1 is given. 


colour = POINT(X,Y) 


This function is used in the Marslander program to 
test whether the capsule has touched down, and 
whether it is on a flat surface. 


<num-var> = POINT (<numeric>, <numeric>) 


Position of text cursor 


None FUNCTION 


This function tells how far across the text screen the 
text cursor is . J is on the left, and the value to the right 
is determined by the mode, and by the size of text 
window. 


X = POS 


<num-var> = POS 
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PRINT 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


PRINT# 


Abbreviation 


Description 


Examples 


Syntax 


Print on screen 


P. or GR / STATEMENT 
This instruction is used for all character output to the 
sereen, 


PRINT “Anywhere” 
PRINT A,B,length,moon$,BILL% 
PRINT HEIGHT*DEPTH;CHRS127; 99; 


PRINT CHRSX; is almost the same in operation and 
effect as VDUX, and the two are interchangeable. 


PRINT is also used to issue control-codes to the 
computer during program execution. 


PRINT CHRS$9 will move the text cursor forward one 
square, for example. 


PRINT {["][,|:]<string>! <numeric>}{"][;] 


Print on file 


P.# STATEMENT 


PRINT# is like PRINT but instead of printing infor- 
mation to the screen it prints it on to a previously 
opened file. Must be followed by channel number (see 
chapter on file handling). 


PRINT# channel, makeS, prices 
PRINT# C,B,A,Z$ 


PRINT# <num-var>{,<numeric>| <string>} 


PROC 


Abbreviation 


Description 


Examples 


Comments 


Syntax 


PTR# 


RAD 


Abbreviation 


Description 


Examples 


Syntax 
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Procedure 


Ga x Prefix 


This prefix is used when defining a named procedure 
(see DEF) and to call this named procedure from 
anywhere in the program. 


PROCrotate 

iF... THEN PROCfire 
DEF PROCfire 
PROCvolume(radius, height) 


PROC must be followed by aname without any spaces. 
Parameters may be passed in brackets. 


DEF PROC<variable-name>|(<string-var> | 
<num-var>{,<string-var> | <num-var>}] 


Reserved for future use. 


Radians 


| FUNC BI FUNCTION 


This function gives an angle in radians which is 
equivalent to the specified angle in degrees. There are 
2*PI radians in a circle of 360°. 


X = RAD(X) 

angle = RAD(angle) 

answer = SIN(RAD(angle)) 

Brackets are optional where sense is not affected. 


<num-var> = RAD <numeric> 
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READ Read data into variable(s) 

Abbreviation None STATEMENT 

Description This instruction tells the computer to copy infor- 
mation from a DATA statement into the variables which 
follow the READ instruction. The types of variables 
must match; numbers must be copied into numeric 
variables and strings into string variables. See DATA 
and chaper on READ and DATA. 

Examples READ name§, Tel, credit 

Syntax READ <num-var>|<string-var>{,<num-var>| 
<string-var>} 

REM Remark 

Abbreviation § None STATEMENT 

Description This instruction tells the computer to ignore the rest of 
the program line, thus enabling the programmer to 
insert comments in the listing without affecting the 
program. 

Examples 18 REM Marslander 
1935 REM Move Alien 

Syntax REM < anything > 

RENUMBER Renumber program line 

Abbreviation REN. or ITTY 8 COMMAND 

Description This command has two optional parameters which 


control the way in which a program is to be re- 
numbered. The value of the first parameter is the 
starting line number. The second is the increment for 


Examples 


Comments 


Syntax 


REPEAT 


Abbreviation 


Description 


Examples 


Syntax 
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each subsequent line number. If either or both para- 
meters are omitted they will default to 16. 


If a program looks like this 


19 wx 
15 xxx 
17 xxx 
38 xx 
32 10x 


RENUMBER 199.5 will change it to 


199 xx 
195 xx 
116 xxx 
115 xxx 
128 xxx 


This command also renumbers all GOTOs, GOSUBs and 
any other cross references, except calculated ones like 
GOTO (8*W) and GOSUB (199+-2). 


RENUMBER {<num-const>(,<num-const>]] 


REP. or GRY Y STATEMENT 


This instruction initiates a REPEAT . . . UNTIL loop 
which tells the computer to REPEAT a set of instruc- 
tions UNTIL a testable condition becomes true. 


REPEAT. .. UNTIL loops may be nested up to a depth of 
29. 


NOW = TIME: REPEAT UNTIL TIME —NOW > = 596 


REPEAT 
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REPORT 


Abbreviation 


Description 
Examples 


Syntax 


RESTORE 


Abbreviation 


Description 


Examples 


Syntax 


RETURN 


Abbreviation 


Description 


REPO. STATEMENT 


This instruction will print up on the screen what the 
last error was, in words. 


REPORT: PRINT ” at line “;ERL 


REPORT 


RES. or GT w STATEMENT 


This instruction restores the ‘DATA pointer’ to the 
beginning of a specified line. The DATA pointer points 
to the next piece of information to be read by a READ 
instruction. If no line is specified the DATA pointer is 
restored to the beginning of the first DATA instruction 
in the program. 


RESTORE 
RESTORE 2569 


RESTORE <numeric> 


Return from subroutine 


R. STATEMENT 


This instruction informs the computer that it has 
reached the end of a subroutine and that it must now 
RETURN to the instruction immediately after the 
GOSUB at which the subroutine was called. A sub- 
routine must not be exited other than by using 
RETURN. 


Examples 


Comments 


Syntax 


RIGHT$ 
Abbreviation 


Description 


Examples 


Syntax 


RND 


Abbreviation 


Description 
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RETURN 

IF A= @f THEN RETURN 

Not to be confused with the HiGMUGLY key. 
RETURN 


Right string 


RI. Includes ( FUNCTION 
A function which gives the specified number of right- 
most characters in a string. 


PRINT RIGHTS("FLAVOUR", 3) will give OUR. 


<string-var> = RIGHTS(<string>,<numeric>) 


Random number generator 


None FUNCTION 


This function, which may be followed by a number in 
brackets, returns a random number. 


RND by itself generates a random whole number 
between —2147483648 and 2147483647 


RND(-X) gives the value —X and resets the random 
number generator to a number based on X. 


RND(@) repeats the last random number given by 
RND(1). 

RND(1) generates a random number between @ and 
9.999999. 


RND(X) generates a random whole number between 
(and possibly including) 1 and X. 


The brackets are compulsory and must immediately 
follow the word RND with no intervening space. 
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Examples 


Syntax 


RUN 
Abbreviation 


Description 


Examples 


Comments 


Syntax 


SAVE 


Abbreviation 


Description 


Examples 


Syntax 


X = RND(18) 


<num-var> = RND[(<numeric>)| 


GOD R (includes FETED) STATEMENT 


This instruction makes the computer initiate execution 
of the numbered program lines in its memory. It also 
clears all variables except the resident integer vari- 
ables. 


RUN 
IF velocity >168 THEN RUN 


A program can be RUN without clearing the variables 
by using the command GOTO, followed by the first line 
number, 


RUN 


SA. or TT. STATEMENT 


This transfers the program from the computer’s 
current program area (between the system variables 
PAGE and TOP) on to cassette, and in future 
expansions, disc as well. When used with tape, SAVE 
must be followed by a name of up to 1@ characters, 
inside quotation marks. 


SAVE “BUGZAP!” 


SAVE <string> 


SGN 


Abbreviation 


Description 


Examples 


Syntax 


SIN 


Abbreviation 


Description 


Examples 


Syntax 


SOUND 


Abbreviation 


Description 
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Sign 


None FUNCTION 


This function tells you whether the specified number, 
variable or expression is positive, zero or negative. 


The function gives: 


~1 for a negative number 
@ for a zero 
+1 for a positive number 


X = SGN(Y) 


Brackets are optional where sense is not affected. 


<num-var> = SGN(<numeric>) 


Sine 


None FUNCTION 


This function gives the sine of an angle, which must be 
in radians. 


PRINT SIN(3.142) 
X = SIN(y) 


Brackets are optional where sense is not affected. 


<num-var> = SIN(<numeric>) 


so. STATEMENT 


Makes the computer generate a sound on the internal 
loudspeaker. 
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Syntax 


SPC 


Abbreviation 


Description 


Examples 


Syntax 


SQR 


Abbreviation 


Description 


The format is: 
SOUND Q,A,P,D 
Q is the channel number, § to 3. 


A is the envelope number, 1 to 4. If A is @ then that 
sound channel is turned off. If A is negative (-1 for 
example) then a pure tone is produced. 


P is the pitch, @ to 255. 
D is the duration, 1 to 255 in twentieths of a second. 
See chapter 22 


SOUND <numeric>,<numeric>,<numeric>, 
<numeric> 


Space 


None (See PRINT, INPUT) 


This statement is used in conjunction with PRINT or 
INPUT to give the specified number of spaces. This 
number may not be greater than 255. 


PRINT “Name”;SPC(19);"Tel.”;SPC(1#);"CREDIT” 
INPUT “Amount” SPC(3) A 


Brackets are optional where sense is not affected. 


PRINT SPC (<numeric>) 
INPUT SPC (<numeric>) 


Square root 


None FUNCTION 


This function gives the square root of a positive 
number. 


Examples 


Syntax 


STEP 
Abbreviation 


Description 


Examples 


Syntax 


STOP 


Abbreviation 


Description 


Example 


Syntax 
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X = soR(y) 
ans = SQR(ABS(NUMBER)) 


Brackets are optional where sense is not affected. 


<num-var> = SQR(<numeric>) 


s. or GID s (See FOR) 


This is part of the FOR... TO... STEP... NEXT 
statement. The number following STEP is the amount 
by which the control variable is incremented in each 
loop, and can be positive or negative, integer or real. 


FOR X = @ TO 59 STEP 5 
FOR | = 19 TO @ STEP -1 
FOR J = 7 TO 11.3 STEP 2*.7 


FOR <num-var> = <numeric> TO <numeric> 
[STEP< numeric>] 


None STATEMENT 


This instruction has the same effect as END but it 
prints the message STOP, and the line number, on the 
screen. 


IF P >Temp THEN STOP 


sTOP 
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STR$ 


Abbreviation 


Description 


Examples 


Syntax 


STRING$ 


Abbreviation 


Description 


Examples 


Syntax 


TAB 


Abbreviation 


Description 


String 


STR. FUNCTION 


This function converts any number or expression in 
the brackets into a string. STR$ has an opposite effect 
to that of VAL. 


AS = STRS(X) 

BS = STRS(—1.23) 

Brackets are optional where sense is not affected. 
<string-var> = STR$ (<numeric>) 


STRI. Includes ( FUNCTION 
This instruction produces a long string consisting of a 
specified number of copies of a shorter string. 


LineS = STRINGS(49,"—") 


<string-var> = STRINGS (<numeric>,<string>) 


None (See PRINT, INPUT) 
Used with either PRINT or INPUT to set the position of 
the text cursor on the screen. 


TAB({X) will move the cursor forward to position X on 
the current line. X can be between @ and 19, @ and 39, 
or § and 79 depending upon which mode is in use. 


Examples 


Comments 


Syntax 


TAN 


Abbreviation 


Description 


Examples 


Syntax 


THEN 
Abbreviation 


Description 
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TAB(X,Y) will move the cursor directly to position X,Y. 
The text cursor has its origin 9,0 at the top left. If a text 
window is in use, then TAB will treat the top left corner 
of that as 6,9. 


PRINT TAB(6,11); “HELLO” 
INPUT "How much” TAB(1§), cost 


The brackets are compulsory, and there must be no 
space between TAB and (. 


PRINT TAB(<numeric> [,<numeric>]) 
INPUT TAB(<numeric> [,<numeric>]) 


T. FUNCTION 


This function gives the tangent of an angle, which must 
be in radians. 


PRINT TAN(PI/2) 
ratio = TAN(.6) 


Brackets are optional where sense is not affected. 
<num-var> = TAN< numeric> 


TH. or GIR T (See IF) 


Provides the course of action if the result of an IF 
statement is true. 


It is an optional keyword, but the program is neater 
and easier to follow when it is left in. 
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Examples 


Comments 


Syntax 


TIME 


Abbreviation 


Description 


Examples 


Syntax 


TO 


Abbreviation 


Description 


Examples 


Syntax 


IF A = B THEN PROCab 


THEN is not optional when assigning certain resident 
variables such as TIME, and when GOTO is omitted. 


IF<testable condition> THEN<statement>[ELSE 
<statement>} 


TI. VARIABLE 


An integer variable which is incremented every 
hundredth of a second. It serves as an elapsed time 
clock, and can be set to any initial value by the user. 


TIME = 9 
TH = TIME 
PRINT TH 


TIME = <numeric> 
<num-var> = TIME 


None (See FOR) 


Used in the FOR... NEXT loop to set the limiting value 
of the control variable. 


FOR 1 = @ 7011 


FOR<num-var> = <numeric> TO <numeric> [STEP 
<numeric>] 


TOP 


Abbreviation 


Description 


Examples 


Syntax 


TRACE 


Abbreviation 


Description 


Syntax 


TRUE 


Abbreviation 


Description 


Examples 
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None VARIABLE 


Address pointer containing the address of the first free 
memory location after the top of the BASIC program. 
TOP—PAGE will give the length of your BASIC program 
in bytes. 


PRINT TOP—PAGE 


<num-var> = TOP 


TR. STATEMENT 


Debugging device which prints BASIC line numbers in 
order of execution. Is turned on by TRACE ON, and off 
by TRACE OFF. TRACE X will only give line numbers 
below X. 


TRACE ON! OFF<numeric> 


None CONSTANT 


This is a condition which the computer understands to 
be the number -1. If the computer decides a certain 
condition is true, it will represent it as —1, and will act 
accordingly. 


IF A = TRUE THEN... 
Test = TRUE 
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Comments 


Syntax 


UNTIL 


Abbreviation 


Description 


Examples 


Syntax 


USR 


Abbreviation 


Description 


In practice, any number other than @ is taken by the 
computer to be TRUE. Care is needed though. NOT(-1) 
is §. NOT(1) is —2. This is because the NOT function 
simply inverts the binary digits, and does not consider 
them true or false at all. 


<num-var> = TRUE 


U. or GIG vu (See REPEAT) 


Conditional part of REPEAT... UNTIL loop. The loop is 
executed until the conditional statement after UNTIL 
goes true. 


REPEAT 

XXX 

XXX 

UNTIL X = 7 

REPEAT These are REPEAT 

XXX the same XXX 

XXX and will XXX 

UNTIL @ loop forever UNTIL FALSE 


UNTIL <testable condition> 


None FUNCTION 


Used from BASIC to call a previously assembled 
machine-code function. Similar in operation to an FN, 
but is not able to pass parameters. Used in preference 
to an FN where long calculation is involved, and speed 
is at a premium. 


Examples 


Comments 


Syntax 


VAL 


Abbreviation 


Description 


Examples 


Syntax 


VDU 


Abbreviation 


Description 


Examples 


Comments 
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X = USR(&1759) 

29 address = &3QA9 

39 PRINT USR(address)} 
See chapter on assembler. 


<num-var> = USR(<numeric>) 


None FUNCTION 
Gives the numeric part of a string as a number. The 
string must start with +, —, or a number, otherwise 0 is 
given. 

number = VAL(—762*12) 

will put number equal to —762. 

<num-var> = VAL(<string>) 


V. or (Ta v STATEMENT 


VDU has almost the same function as PRINT CHRS. It 
can be used to give any character or control code from 
the ASCII table in Appendix F. 


VDU5 Link text and graphics cursors. 
VDU8 Move text cursor back one square. 
VDU23 Re-define character. 


Sends code directly to the VDU drivers. Is quicker to 
type than PRINT CHRS. 


PRINT TAB(X.Y) is equivalent to 
VDU31,X.Y 
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Syntax 


VPOS 


Abbreviation 


Description 


Examples 


Syntax 


WIDTH 


Abbreviation 


Description 


Examples 


Syntax 


VU <numeric> {, |; <numeric>} [)] 


VP. FUNCTION 
Gives the distance of the text cursor from the top of the 
screen or text window. 

Y = vPOos 

PRINT VPOS 


<num-var> = VPOS 


Ww. STATEMENT 


Sets the width used by the computer to print on the 
screen. This is normally unlimited, and the computer 
runs on to the next line at the right boundary of the 
screen or text window. 


WIDTH 19 will cause the text to be printed in a column 
16 characters wide. 


WIDTH <numeric> 


26 Cassette file 
handling 


Aside from saving programs, data files can be opened on the cassette: for 
example to store addresses or telephone numbers. 


Here is a list of file handling commands which you can use: 


*CAT Gives a catalogue of all data files and programs on 
the cassette. It takes a very long time on a cassette. 

OPENIN Opens a file so that it can be read. 

OPENOUT Opens a new (empty) file for writing. 

OPENUP Opens a file for reading or writing. 

INPUT# Reads data from a file into the computer. 

PRINT# Writes data from the computer into a file. 

BGET# Reads a single character (byte) from a file. 

BPUT# Writes a single character (byte) to a file. 

EOF# Indicates whether or not the end of a file has been 
reached, 

CLOSE# Indicates to the computer that you have finished with 
a file. 


To create a data file, you must first open it using OPENOUT. OPENOUT 
must be assigned to a variable, as follows: 


A= OPENOUT “stamps” 


In this case, the file called ‘stamps’ has been opened, and is allocated toa 
variable called A. A becomes the communication channel to the file, and 
all data sent to the file is routed via A. For example, if you want to write 
the names of all your stamps into the file, you use PRINT#: 


10 A = OPENOUT "stamps" 

20 REPEAT 

3@ INPUT "Give the name of the stamp",name$ 
40 PRINT# A, nameS 

5Q@ UNTIL name$S = "NO MORE” 

60 CLOSE# A™ 
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So after the file has been opened, its name is not mentioned again. The 
above program will allow you to make a list of names and, if the cassette 
player is switched on, they will be recorded on tape. Notice that the file 
must be closed after use, with CLOSE#. 


To get the data back into the computer, you must open the file for 
reading using OPENIN. (The tape must be wound to the start of the file, 
and the PLAY button pressed). 


A = OPENIN "stamps" 


The variable name, in this case A, is completely arbitrary. You could 
equally well call it FRED, file, or anything else you wish. To read data 
from the tape into the computer’s memory, use INPUT#: 


10 A = OPENIN "stamps" 

2@ REPEAT 

36 INPUT# A, name$ 

40 UNTIL name$ = "NO MORE" 
6@ CLOSE# A 


Line 4@ could equally well read: 
4@ UNTIL EOF# A 
EOF# is a logical file operator which is TRUE when the end of the file has 


been reached. 


PRINT# and INPUT# are used to write or read strings to and from the 
cassette file. The instructions BPUT# and BGET# are used to write and 
read single characters. 


*CAT may be used anytime to give a catalogue of all program and data 
files on tape, and *. can be used as an abbreviation. 


Cassette operations print messages on the screen, and sometimes 
cassette operations will produce errors. The message printed, and the 
computer’s reactions to errors can be altered using *OPT: 
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*OQPT1,X controls all but the error messages which are printed on the 
screen. 


X=9@ Gives no messages. 
X= 1 Gives short messages (as normal). 
X=2 Gives long messages, including load and execution addresses. 


*QPT2,X controls the computer’s action. 

X= Lets the computer ignore all errors, and carry on regardless. 
Messages can still be given. 

X=1  Thecomputer asks you to try again by rewinding the tape (as 
normal). 

X=2 The computer aborts the operation. 


*QPT3,X sets the inter-block gap in tenths of a second. This only applies 
to PRINT# and BPUT#. The gap on SAVE is fixed to 9.6 seconds. 


*OPT on its own sets all the values to normal. 
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So far you have seen that when the computer finds an error it halts 
execution of the program and prints a message on the screen. Some 
errors are generated by incorrect programming and these are the ones 
that you have to correct. But what about errors which occur during the 
execution of a good program, because either the data is wrong or the user 
inputs something that the computer cannot handle? 


Look at the following program: 


10 REPEAT 

20 INPUT "NUMBER", N 

30 L = LOGC(N) 

40 PRINT "LOG OF "ZNZ" IS "ZL 
5@ UNTIL FALSE 


This is simple enough. It takes a number from the keyboard, and gives 
you the log of that number. But, if you type in a negative number, the 
program comes to a halt with: 


Log range at Line 30 


The same thing happens if you type 9, or a character such as W, or a word 
such as TWELVE. 


It is easy to trap such an error, and to print a message to tell the user what 
he or she has done wrong. Every error has an error number, which is 
stored in a variable called ERR. You will find a list of these errors in 
Appendix B. The number for the log error is 22, so we can alter the 
program as follows: 


5 ON ERROR GOSUB 100 

10 REPEAT 

2@ INPUT "NUMBER", N 

3@ L = LOG(ND 

40 PRINT “LOG OF "3N3" IS "ZL 

5@ UNTIL FALSE 

10@ IF ERR = 22 THEN PRINT “MUST BE A POSIT 
IVE NUMBER > Q" 

11@ RETURN 
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Now, if an illegal input is made, the program simply prints a message 
telling you what you have done wrong, and carries on running. The 
trouble is, it carries on running, and running, and running. The 

key has no effect. This is because ESCAPE fa treated as an error; it even 
has its own error code: 17, You'll have to press | BREAK Ff then OLD 
to get the program back. 


To overcome this, RETURN can be incorporated into line 199: 


100 IF ERR = 22 THEN PRINT “MUST BE A POSIT 
IVE NUMBER > @":RETURN 


Now, the | ESCAPE | key works, but no message is printed to say what 
happened, or at what line. Don’t forget to delete line 11! 
To print the message, the instruction REPORT is used. 


11@ REPORT 


will print the message Escape on the screen. 

The line number at which errors occur is stored ina variable called ERL. If 
you add a line 126: 

12@ PRINT “ at Line “;ERL 


then the correct message will be printed up on the screen. 


The above example is fairly simple, because there is only the one error 
which can occur. If you write a program that other people will use, you 
will have to think of all the possible errors that may occur, and trap them 
accordingly. In the example, the instruction used was 


ON ERROR GOSUB 
Other useful error trapping instructions are: 


ON ERROR GOTO 
ON ERROR PRINT 
ON ERROR PROC 


If you do use GOTO, you cannot ‘GOTO’ back again into a FOR... NEXT 
loop, a REPEAT . . . UNTIL loop, or a function. See Appendix B for alist of 
errors and their codes. 


28 Merging BASIC 
programs 


Two methods are given here by which you can merge two BASIC 
programs which are stored on cassette, and in future expansions, disc as 
well. 


(i) This method requires you to LOAD one of the programs (preferably the 
shorter) and then to re-save it as an ASCII file using *SPOOL. You can 
then LOAD the other program; and the spooled program will be entered as 
the equivalent of keyboard input by loading it using *EXEC. Assuming 
that the two programs are called LARGE and SMALL, the procedure is as 
follows: 


LOAD "SMALL" 
Now set the tape recorder to a blank section of tape. 


*SPOOL "SMALL" 
LIST 
*SPOOL 


The program SMALL is now saved as an ASCII text file. 


LOAD "LARGE" 
*EXEC "SMALL" 


The merger is now complete. Any line numbers in LARGE that coincide 
with those in SMALL will be overwritten. If you want to add SMALL to the 
end of LARGE then you have to adjust the line numbers before SMALL is 
spooled. When you use *SPOOL, anything that is output to the screen is 
also sent to the cassette. That is why you must type LIST. *SPOOL without 
the file name closes the file that has been spooled. 


(ii) This is a slightly simpler method, but the line numbers of SMALL must 
be adjusted so as all to be higher than the highest line number in LARGE. 
The idea is to LOAD the program with the lower line numbers, and *LOAD 
the program with the higher numbers at TOP-2. Lastly, it is necessary to 
type END so that the computer can trace the lengthened program. 
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The procedure is: 


LOAD "LARGE" 


OSCLI “LOAD ""SMALL""" + STRS”C(TOP-2) 
END 


This method is very easy, but you must be careful to adjust the line 
numbers. 
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Introduction 


The computer's ‘brain’ has its own language, and that language is not 
BASIC, Every time you run a BASIC program, each line has to be 
translated before this brain {the computer’s central processor unit) 
can understand it at all, This translation is accomplished by a device 
called an interpreter, which resides in the computer’s memory. The 
action of this device need not concern you, but it is itself a program 
written in machine-code, and machine-code is the computer’s own 
language. 


There are 55 different instructions in machine code, which is about half 
the number of BASIC instructions available on the Electron. Each of 
these instructions acts upon one or more of the registers inside the 6562 
microprocessor (6592 is the type-number of this processor — it has no 
significance). A register is just like a byte of memory. The 6592 contains 
six registers, five of them being 1 byte long, and the last being 2 bytes 
long. These registers are not a part of the computer’s memory map (from 
location &9909 to &F FFF); they live an entirely separate existence in the 
heart of the microprocessor. But the machine-code instructions which 
control these registers are stored in the computer’s memory, in the 
position on the memory map labelled ‘operating system’. These instruct- 
ions don’t look much like intelligible commands, for they are simply 
binary numbers — 141619419990191@ for example. It is very difficult to 
program using such low-level instructions; even in hexadecimal they 
hardly look any better: A9 GA. This is the reason for using Assembly 
Language. 


Assembly Language uses a three-letter mnemonic to represent each 
machine-code instruction. Each mnemonic is a contraction of the action- 
in-words of that instruction. 


Take the instruction given above. One of the registers in the micro- 
processor is called the accumulator (all the registers will be described in 
detail in a moment). 


A9 means ‘load the accumulator’. 
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The mnemonic for this is LDA, thereby giving you a rough guide to its 
function, LoaD Accumulator. 


The other part of the instruction, @A, is 19 in decimal. So A9 A means 
‘put 19 in the accumulator’, and this is written in Assembly Language as: 


LDA #19 


(The hash (#) tells the computer that it is the 16 which is to be put into 
the accumulator, and not the contents of memory location 19. This will 
be explained in a moment.) 


So, each of the 55 machine-code instructions is assigned a three-letter 
assembly mnemonic, which enables you the programmer to understand 
the function of each, without having to look it up on a chart. 


The Electron has another program in its memory, called an assembler, 
and this converts the Assembly Language directly into machine-code. 
During this assembly process, the computer can help you by giving error 
messages and a listing of the machine-code in hex. (If you were 
programming the 6592 direct in machine-code there would be no error 
messages at. all — and just try finding a mistake among a few hundred 
machine-code instructions!) 


The assembler loads the machine-code into memory, and it can then be 
run, either as a CALL or USR from BASIC, or by using *RUN. 


Registers in the 6592 


The 6592 microprocessor has six registers as follows: 


Accumulator 

The accumulator is the main working register of the processor. Most of 
the 55 Assembly Language instructions operate on the accumulator, 
which gained its name from the way that results of arithmetic operations 
are ‘accumulated’. It is an 8-bit register, meaning that it can store and 
operate upon eight binary digits (one byte). Each bit is designated a 
number, from @ for the least significant (rightmost) to 7 for the most 
significant (leftmost). 
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Common operations involving the accumulator are: 


— Loading it from memory (the locations &4900 to &F FFF). 
— Storing its contents in memory. 

- Addition or subtraction. 

~ Logical functions (AND, OR, or EOR). 

— Shifting its contents left or right. 


Index registers X and Y 
The two index registers are each 8-bits long, and are used for the 
following: 


— To be added to the address used by an instruction. This is called 
indexing. 

— As general purpose registers for various counting or short term 
memory duties. 

— In addition to the above, both the accumulator and the two index 
registers are used by the Electron to pass parameters to operating 
system subroutine calls. This will be explained later. 


Program counter 


The program counter is the only 16-bit register, and it holds the memory 
address of the next instruction to be executed. 


Operations involving the program counter are: 


- Jump and branch instructions which alter the contents of the PC 
and thereby divert the flow of the program. (Much like GOTO in 
BASIC.) 


Stack pointer 

The stack pointer is an 8-bit register, with a ninth bit on the most 
significant end which is always set to 1. It is an address pointer which 
gives the location in memory of a special kind of data-structure used by 
computers called the stack. It can point to addresses between &919 and 
&@1FF. The stack is explained later, but in essence it is a section of 
memory which has not only a position, but also an order. Thus, data 
which is pushed on to the stack in one order, can only be pulled off it in 
the reverse order. This sort of memory is called last in first out (LIFO). It 
is used for storing data in which the order is important, eg execution 
addresses of nested subroutines. 


Assembly Language 25 


Flags register 

The flags register is different from all the others in that it operates as 
seven single-bit registers: N, V, B, D, I, Z, C. Each bit signals a condition 
in the processor, and certain instructions act upon these conditions 
(whether that condition is present, true; or is not present, false). 


Each bit acts as follows: 


Bit N is set to 1 when the last operation produced a negative result. A 
negative result is signified by the most significant bit of a register being 1 
(the sign bit). In the case of the accumulator, a result inside it of, for 
example, 19019190 would set bit N of the flags register to 1. If the last 
operation did not produce a negative result then bit N is reset to @. 


Bit V is set to 1 when the last operation overflowed into the sign bit, As 
stated above, the sign bit is bit 7 in the case of the accumulator, so bit V is 
set to 1 when there is a carry from bit 6 to bit 7. This is important to know 
when using twos complement arithmetic, for it means that an error has 
occurred which must be corrected. 


Bit B is set to 1 when the BRK command is used (break). (This command 
has much the same effect on a machine-code program that | ESCAPE | has 
on a BASIC program.) 


Bit D, when set to 1, causes the processor to operate in BCD mode 
(binary coded decimal). When reset to , the processor works as normal 
in binary. BCD is beyond the scope of this book, and need not concern 
you. 


Bit I is the interrupt mask. When it is set to 1 no interrupts are accepted. 
Interrupts are also beyond the scope of this book. 


Bit Z is set to 1 when the last operation produced a zero result. 


Bit C is the carry register. It is set to 1 by acarry from the most significant 
bit of one of the registers, usually the accumulator. 


These flags are used by the branch instructions, which direct the flow of 
the program according to the conditions. For example, BEQ means 
‘branch if equal to zero’. The program will branch if the Z bit is set to 1. If 
not it will not branch. 
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Addressing modes 


Take a single instruction — you have seen LDA before. Its function is 
always to ‘load the accumulator’, but it may load it in different ways and 
from different places according to which addressing mode is used. 


LDA #19 
means ‘load the accumulator with 19’. You know that already. However, 


LDA 19 


means ‘load the accumulator with the contents of memory location 19”. 


This is an example of two different addressing modes. The first is 
immediate addressing. The instruction uses the data immediately, 
without looking for it in memory. The second is zero-page addressing. 
The instruction uses the contents of the address specified. It is called 
zero-page because the computer’s memory is divided up into 256 pages 
each of 256 bytes. Any address which has its two most significant hex 
digits as zero is said to be in the zero-page of memory. The zero-page 
extends from locations &#69% to &OOFF. 


LDA may also be used with a full 16-bit address: 
LDA &39A7 


will ‘load the accumulator with the contents of memory location &3@A7’. 
This addressing mode is called absolute, It can access any location in the 
computer’s memory. Notice that the assembler treats numbers as 
decimal, unless they are preceded by &. 


Immediate, zero-page and absolute are not the only addressing modes, 
although they are the most simple to understand. 


LDA &1D77,X 


is an indexed addressing mode. 


The address used by the instruction is &1D77 plus the contents of index 
register X. So the accumulator is not loaded from &1D77 but from 
&1D77+X. Note that the contents of index register X are added to the 
address, and not to its contents. 
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The index register used can equally well be Y: 
LDA &2509.V 


(Note: When using machine-code there are several subdivisions of the 
above indexed addressing mode, but using the assembler takes care of all 
those for you. However, the assembled machine-code (in hex) will not 
always be the same for the same indexed instruction.) 


Another still more complicated addressing mode is indirect addressing: 
LDA (&1B,X) 


The address given after the assembler mnemonic, in this case &1B, must 
be a location in the zero-page of memory (or an error will result). This 
location is then added to the contents of the X register, to give another 
location in the zero-page. The contents of this new location, and the 
contents of the location above it, together supply the full 16-bit address 
of the location from which the accumulator is loaded. So, if &1B+X 
contains &AA, and &1B+X+1 contains &BB, then the accumulator will 
be loaded with the contents of memory location &AABB. 


The above operation is called pre-indexed indirect addressing; the 
indexing is the addition of the X register, and the direction is the use of 
the two consecutive locations at the intermediate address as an address 
pointer to the actual location used. It is called pre-indexed indirect 
because the indexing is done before the indirection. All pre-indexed 
indirections must use index register X. 


Post-indexed indirect addressing is written in Assembly Language as 
follows: 


LDA (&27).Y 


In this addressing mode, the indirection occurs first. The address given 
after the assembler mnemonic, in this case &27, must again be a location 
in the zero-page of memory. The contents of this location and the 
contents of the location above it together give a 16-bit address. To this 
16-bit address is added the contents of index register Y, and this final 
address is the location from which the accumulator is loaded. All post- 
indexed indirections must use index register Y. 
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The above examples show the complete range of addressing modes 
which can be used with the instruction LDA. However, there are three 
more important addressing modes which are used with certain other 
instructions. 


All of the branch instructions use a relative addressing mode. BEQ was 
mentioned in the description of the flags register; it means ‘branch if 
equal to zero’. A branch is an instruction which has an offset: 


22ZZ data 
BEQ Label 
AAA data 
BBB data 
Label CCC data 
DDD data 


In this fragment of program, the triple-letters can be any assembler 
instructions. When a program is running, the program counter is 
incremented one step at a time to point at the next location which is to be 
executed. In this example, when BEQ Label is being executed the 
program counter will point to the line containing the instruction marked 
AAA. If the result of checking the Z flag is that the previous operation did 
not produce a negative result then execution will continue at the line 
containing AAA. If the previous operation did give a zero result then the 
program counter is incremented until it points at the line marked Label. 
This program illustrates the use of labels in assembler. They can take 
any name that you choose (subject to the same limitations as a BASIC 
variable name), and are signified by the fact that they must always start 
with a full stop. 


Branch instructions may branch to labels either forwards or backwards, 
but not too far. The actual distances are 128 bytes backwards or 127 
bytes forwards; but remember that these are measured from the next 
instruction following the branch, and that each instruction may be either 
I, 2, or 3 bytes long. The assembler will soon tell you if you have an 
address or label out of range. 


The next addressing mode is accumulator addressing, which is used by 
only four instructions in the 6542 set. These are ASL, LSR, ROL, and ROR, 
and their action is explained in the reference section. In essence, they 
shift the bits of a memory location or the accumulator to the left or right. 
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ASL &769 


means shift the contents of memory location &76@ one bit to the left. In 
order to apply this instruction to the accumulator, the accumulator’s own 
addressing mode is used: 


ASL A 


means shift the contents of the accumulator one bit to the left. Look up 
the four instructions in the reference section for more information. 


The final addressing mode which you need to know about is the simplest. 
Certain instructions, such as BRK (break) do not need any data or 
memory reference at all. These are called implied instructions and they 
carry out a simple task, usually on one of the registers; for example CLC 
meaning ‘clear the carry flag’. 


Addressing mode Examples 

Immediate LDA #68 LDA #number 
Zero-page LDA &9B LDA address 
Absolute LDA &8E17 LDA address 
Indexed LDA &AQ6C.Y LDA table,X 
Pre-indexed indirect LDA (&72,X) LDA (pointer,X) 
Post-indexed indirect LDA (&98).Y LDA {zero),Y 
Relative BEQ Repeat BNE Loop 
Implied cic BRK 
Accumulator LSRA ROLA 


The examples on the right show the assembler mnemonics used not with 
specific addresses, but with BASIC variables. You will find out that this 
is a good way of writing assembler subroutines which are to be called 
from within BASIC programs by CALL or USR. 


One final point about addressing modes. The JMP (jump) instruction is 
the only one which allows straight indirect addressing (non-indexed). 
JMP is very similar to BASIC’s GOTO. It can take a full 16-bit address 
and place this value in the program counter — hence the program jumps 
to a new execution address. It is usually used with a label, just like 
branch, but without the restriction on distance. In absolute mode it 
would look like this: 
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JMP Label 


If you wish to use it in indirect mode then simply enclose the address in 
brackets: 


JMP (#2147) 


It will then use the contents of the two consecutive locations at &21A7 as 
an address pointer to the location to which it will jump. 


JMP &21A7 


B21A7 32 
876 


&3276 continue execution. 


Entering assembly mnemonics 


This section tells you how to write Assembly Language subroutines, and 
how to call them from BASIC. You may find it worthwhile, now that you 
know about the 6542 processor’s make-up, to read all of the assembly 
mnemonic definitions. You will then be able to understand much more 
clearly the capability of the processor, and what the short programs in 
this section are doing. 


Sections of Assembly Language are entered as part of a BASIC program, 
separated from the BASIC part by the square brackets | and ]. The 
general structure of a program containing an assembler routine is: 


19 REM BASIC program 
199 [ 


119 \ Start of assembler mnemonics 


299 | 
219 REM BASIC program continues 
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Notice that remarks in the Assembly Language section are signalled by a 
backslash \ . The assembler then knows to ignore them. 


Before the routine can be assembled, the computer must be told where it 
is to be put in computer memory. So the first line of the BASIC part must 
allocate some memory for this purpose, and there are two ways in which 
you can do this. 


On entering the assembler routine, you assign to the resident integer 
variable P% the value you choose to be the address of the first instruction 
of the assembled machine code. P% is the ‘pseudo program counter’, 
used by the assembler, to calculate addresses for branch and jump 
instructions and as the pointer for the assembled codes. (When 0% is not 
being used). 


The two methods for doing this are: 


(i) By direct assignment: P% = &299@ for example. The problem with 
direct assignment is that you have to ensure that the memory location 
chosen is available for use. 


The second method gets round this problem. 


(ii) By using the BASIC DIM instruction. This takes the form DIM P% 
19. Note the use of spaces, and no commas or brackets, to distinguish it 
from an array dimension. DIM P% 199 allocates 191 bytes of memory for 
the machine-code, which will be stored along with all the BASIC 
variables above LOMEM. The number used with the DIM instruction 
must be large enough so that sufficient space is reserved to hold all the 
code, but not so large as to overlap other items in the memory. 


An even better way in which to use DIM is: DIM Q% 199 followed by P% 
=0%. DIM is a convenient way of reserving space for machine code 
routines. No check is made to prevent the assembled code from 
overrunning the space reserved for it. 


Assembly 


To get the computer to assemble the routine into machine-code, you 
simply RUN the program. To complete the assembly, the program has to 
be RUN twice. The reason for this will become clear in a moment. The 
assembler pseudo-operator OPT controls the listing and error output 
generated on assembly. This operator must be placed in the assembler 
routine, usually at the start, and is followed by a number from § to 3 
which causes the following outputs: 
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OPT No errors printed, no listing given. 
OPTI No errors, but a listing is given. 
OPT2 Errors are printed, but no listing. 
OPT3 Both errors and a listing are given. 


The listing given is of the machine-code, in hexadecimal. The errors are 
printed as messages on the screen. 


Here’s an Assembly Language routine: 


19 DIM Q% 199 
29 P% = a% 
39 [OPT3 

49 LDA &7¢ 

5g CMP #9 

69 BEQ Zero 

78 STA &72 

89 .Zero RTS 
99 J 


When you RUN this program, the computer will print a listing, and then 
the message: 


No such variable at line 69 


Routines which have forward reference to labels (Zero is referred to on 
line 64 when the assembler has not yet come across it) will always 
generate an error. The answer to this is to inhibit errors the first time 
through by using OPT#, and then to RUN a second time to generate the 
complete code. This is called two-pass assembly. 


The way to do this is to enclose the routine in a FOR. . .NEXT loop as 
follows: 


18 DIM Q% 199 

26 FOR | = @ TO 3 STEP 3 
38 P% = 0% 

4g [OPTI 

59 LOA &79 

69 CMP #9 

79 BEQ Zero 
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89 STA 872 
99 .Zero RTS 
100 J 

119 NEXT 


On the first time through the loop, I= @ and so there will be no listing and 
no error reported. This run allows the computer to identify the forward 
referenced label. The second time through the loop, I=3 and hence a list 
of compiled code is produced, along with any programming errors. Note 
that the assignment statement P% = Q% is enclosed within the loop so 
that it is reset before each pass. 


On running this program, you will see a listing of the assembled machine- 
code alongside the Assembly Language mnemonics: 


> RUN 

GE75 OPT 
gE75 AS 79 LDA &79 
GE77 CS gg CmP #9 
GE79 FO 62 BEQ Zero 
GE7B 85 72 STA &72 
@E7D 69 Zero RTS 


This means that the mnemonics have been successfully assembled, and 
the corresponding machine-code has been loaded into addresses &@E75 
to &§E7D. &A5 is stored in location &$@E75, &7 in location &GE76, &C9 
in location &$E77, and so on to 69 which is stored in location &@E7D. 
This is nine bytes of machine-code in all. 


This routine has not yet been executed. To do that a CALL from BASIC is 
required: 


CALL O% Gia 


Nothing is printed on the screen when you do this, and that’s because the 
program is trivial; it merely loads a byte from memory location &79 into 
the accumulator, and if it isn’t zero it is stored in memory location &72. 
There are some points to note about the structure of the Assembly 
Language routine: 


214 Assembly Language 


— When a label is assigned to a line, as at line 9¢, it must be preceded by 
a full stop. When the label is called by an instruction, as at line 79, 
there must be no full stop. 

— Most Assembly Language routines end with RTS (return from sub- 
routine) which transfers control back to the BASIC interpreter. 

~ The above routine uses two locations in the zero page of memory. 
Only locations &74 to &8F in the zero page may be used by your own 
programs; all the remainder is taken up by the operating system’s 
variables, and BASIC’s workspace. 


Execution by USR 
USR is similar to a BASIC FN (function); it gives a single value. 


The format is: 
R% = USR(Z) 


where Z may be a label pointing to the first assembler mnemonic, or the 
address of the first instruction in machine-code. A label is easier to use 
since it requires no knowledge of where the machine-code is placed in 
memory. When R% = USR(Z) is executed, the least significant byte of 
each of the BASIC integer variables A%, X%, and Y% is placed into the 
accumulator, X register, and Y register respectively. The least significant 
bit of C% is placed in the carry flag (bit C of the flags register). A%, X%, 
Y%, and C% can therefore be used to initialise the 6592 registers before 
entry into the assembler routine. Control then passes to the subroutine 
pointed to by Z. On returning to BASIC (after RTS), the four bytes 
comprising R% will each contain the contents of one of the 6592 registers, 
as follows: 


R% = PYXA 


So R% contains the flags, Y register, X register, and accumulator in that 
order. 


Any or each of these registers may be extracted from R% by setting up a 
mask using AND. To get the accumulator, the least significant byte is 
required: 

Acc —R% AND &FF 


Similarly for X, Y: 
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X = (R% AND GFFQY) DIV Sigg 
Y =(R% AND SFFOGGG) DIV S1pgg0 


To get the flags: 


19 DIM BLOCK 3 
29 IBLOCK = USR(Z) 


Then (Acc = BLOCK?§, X = BLOCK?1, Y = BLOCK?2), the flags = 
BLOCK?3 


Here is a program which uses USR. The Assembly Language routine adds 
the numbers held in X% and A%, and gives the result in the accumulator: 


19 DIM Q% 199 

29 FOR | = § TO 3 STEP 3 

3g P% = 0% 

4g (OPT | 

59 .Start STA &89 

69 TXA 

79 CLC 

89 CLD 

99 ADC &89 

199 RTS 

119 ] 

129 NEXT 

139 INPUT “First number “A% 

149 INPUT “Second number “X% 
159 Registers% = USR(Start) 

160 Sum% = Registers% AND &FF 
179 PRINT “Sum of two numbers is “;Sum% 


When RUN, you will see the following: 


>RUN 

GFGA OPT | 

GFRA 85 89 Start STA &89 
@FOC BA TXA 

OFOD 18 cLe 

GFPE DS cLD 

OFOF 65 89 ADC &89 

GF11 68 RTS 


First number 1i 
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Second number 12 
Sum of two numbers is 23 


The numbers 11 and 12 are entered by the user, and are stored in the 
integer variables A% and X%. The USR call tells the computer to start 
executing the assembly routine from the label Start. Before this 
happens, the least significant byte of A% is placed in the accumulator, 
and the least significant byte of X% into the X register. The machine- 
code corresponding to the assembler mnemonics is now executed in 
sequence: 


STA &8@ stores the contents of the accumulator in memory location &89. 
TXA transfers the contents of the X register to the accumulator. 


CLC clears the carry flag prior to addition. If this is not done then a 
spurious carry may be added to give an incorrect result. 


CLD clears the D flag so that the 652 is working in binary mode. 


ADC &89@ adds the contents of the accumulator to the contents of memory 
location &8, plus the contents of the carry flag; and places the result in 
the acccumulator. 


RTS returns control to BASIC. 


Back in the BASIC section, Registers% now contains the four 65¢2 
registers’ contents. The result is in the accumulator, so the least 
significant byte of Registers% is placed into Sum%, which is then printed 
to give the answer. Note that this routine performs only a single-byte 
addition, so any result given in Sum% will be MOD 256. 


Execution by CALL 
CALL is similar to a BASIC PROC (procedure). 


Here is another addition routine: 


19 DIM Q% 198 

29 FOR 19 TO 3 STEP 3 
39 P% = O% 

4g [OPT I 

59 .Start CLC 

69 CLO 

79 LDA &89 

89 ADC &81 
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99 STA &82 

199 RTS 

119] 

129 NEXT 

139 INPUT “First number “numberi% 
149 INPUT "Second number “number2% 
158 7889 = numbert% 

169 7&81 = number2% 

179 CALL Start 

188 Sum% = 7&82 

198 PRINT “Sum of two numbers is ":;Sum% 


This program illustrates the use of the indirection operator ?. Indirection 
operators are very useful when calling assembly routines. 


Here is a list to refresh your memory: 


7&88 = J% Will put the least significant byte of J% in 
location &89. 

189 = &12345678 Will put &78 in location &8@, &56 in location 
&81, &34 in location &82, and &12 in location 
&83. 

$V% = "FAULT" Will put the string “FAULT” plus a carriage 
return ({M) in locations starting at V%. V% 
must not be in zero page. 


S% = 7889 Will read the contents of location &89 (1 byte) 
into S%. 
R% = 1887 Will read 4 bytes from locations &87 to &8A 


into R%; &8B being the most significant, &87 
the least significant. 
R$ = $8290¢9 Will read a string starting at &2999 into R$. 


The addition program shown above has exactly the same effect as the 
previous example. In this instance though, the two numbers are stored 
into memory in the BASIC part of the program, and are added and the 
result stored in the Assembly Language part. 


CALL may also be used with parameters, similar to PROC. This takes the 
form: 


CALL Start,integer%,decimal,string%, ?byte 


The parameters are separated by commas. Start is a label, but could 
equally well be a specific address, &2609 for example. The above CALL 
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shows that any kind of variable may be passed as a parameter: integer, 
real, string, and single-byte. When a CALL is made, the parameters are 
assigned to a parameter block, which starts at memory location &669. 
The format of this parameter block is: 


Address Contents 


&60G Number of parameters 

&691 1st parameter address (low) 
&6G2 1st parameter address (high) 
&693 1st parameter type 

&604 2nd parameter address (low) 
&665 2nd parameter address (high) 
&696 2nd parameter type 


There may be any number of parameters, and this number is given in the 
first byte of the parameter block. Following this, each parameter’s 
address and type is given. 


The type is designated by a number: 


9 A single byte (eg ?location) 

4 A 4-byte variable (eg Z% or !address) 

5 A 5-byte variable (eg number) 

8 A defined string (eg “YES PLEASE”) which must end 


with &D (GYRO) 


129 A string variable (eg name$) 


The way that the parameter block is laid out, it would seem that the best 
way to access the individual parameters is to use indirect addressing. 
Unfortunately, the 6592 only allows the zero-page to be used for indirect 
address pointers, so here is a routine which transfers the addresses from 
the parameter block into free locations in the zero-page: 


LDA &699 \ Check the number of parameters. 
BEG End \ If zero then finish. 
STA &79 \If not then store this number. 
LDX #9 \Clear the X register 
LOY #9 \and the Y register. 

.Loop LDA &691,Y \Take high address of parameter. 
STA &71,X \and store it in zero-page. 


INX \ Increment X register. 
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INY \ and Y register. 
LDA &691,Y \ Take low address of parameter. 
STA &71,X \ and store it in zero-page. 
INX \ Increment X register 
INY \ and Y register 
INY \ twice. 
DEC &79 \ Decrement number of parameters. 
BNE Loop \ If still not zero then repeat. 
.End = ATS \ Return to BASIC. 


This routine stores the address of each parameter in zero-page memory 
starting at location &71. 15 parameter addresses may be stored in this 
way before the total user zero-page memory is filled. This routine is very 
useful if the number of parameters passed to a particular Assembly 
Language subroutine is not always the same, for it will only relocate the 
addresses of those parameters which exist. 


Here this routine is incorporated into another addition program: 


19 DIM Q% 199 
29 FOR 1=§ TO 3 STEP 3 
3g P% = Q% 
4g [OPT I 

59 .Start CLC 
69 CLO 

79 LDA &609 
89 BEQ End 

99 STA &79 
199 LDX #9 
119 LOY #9 
129 .Loop! LDA &691,Y 
139 STA &71,X 
149 INX 

159 INY 

169 LDA &691,Y 
179 STA &71,X 
189 INX 

199 INY 

299 INY 

2198 DEC &79 
229 BNE Loopi 
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236 .End LDX #@ 

249 STX 2999 

259 LDY sogg@ 

269 BEQ Finish 

279 .Loop2 LDA (&71,X) 

289 ADC &29¢9 

299 STA &299¢9 

399 INX 

319 INX 

3268 DEY 

33@ BNE Loop2 

349 .Finish RTS 

359 | 

369 NEXT 

379 INPUT" First number “one% 
389 INPUT’Second number “two% 
399 INPUT’ Third number “three% 
499 CALL Start,one% 

419 Sum%=7829009 

429 PRINT Sum% 

439 CALL Start,one%,two% 

440 Sum%=?7&2900 

459 PRINT Sum% 

469 CALL Start,one%,two%,three% 
479 Sum%=782999 

489 PRINT Sum% 


The parameter block transfer routine ends at line 249, where the 
addition routine begins. Notice that the whole routine is CALLed with 
varying numbers of parameters, just to prove that it works. The result of 
adding the parameters is given in location &2669. However, as with the 
previous programs, the result is MOD 256. 


Quadruple precision addition 


Integer variables are stored in four consecutive bytes of memory. Groups 
of four bytes can be accessed using !, and can be added together. This is 
achieved a byte at a time, starting with the least significant, and storing 


each successive result: 


1f DIM Q% 199 
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29 FORI = § T0 3 STEP 3 


38 P% = 0% 

4g [OPT 1 

59 .Start CLC \Clear carry for ADC instruction 
68 CLD 

70 LOX #9 \ Clear X register 

89 LDY #4 \ Set Y register to 4 as a counter 
99 .Loop LDA &76.X \ Put byte from one% in accumulator 
198 ADC &74,X \ Add byte from two% 

118 STA &78,X \ Store result 

129 INX \ Increment X register 

139 DEY \ Decrement Y register 

149 BNE Loop \ lf not zero then repeat 

159 RTS 

168 | 

176 NEXT 


1890 INPUT "First number “one% 

199 INPUT "Second number "two% 

200 '&79 = one% 

216 !874 = two% 

229 CALL Start 

239 sum% = !&78 

249 PRINT “Sum of two numbers is “;Sum% 


This program will work with positive or negative integers, 


Multiplication 


The 6592 does not have a multiply instruction. Multiplication is 
achieved by adding and shifting, just like ordinary decimal long- 
multiplication. As a simple example, take the multiplication of two 4-bit 
numbers. Such a multiplication can give an 8-bit result: 


(i) Test the rightmost bit of the multiplier. If it is zero then add 6609 to 
the most significant end of the result. If it is 1 then add the number to be 
multiplied to the most significant end of the result. 


(ii) Shift the result one bit position to the right. Repeat (i) for the next bit 
of the multiplier. 


Applying the above to 1161*1991, the rightmost bit of the multiplier 
(1901) is 1. Therefore 111 is added to the most significant end of the 
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result: 

1191 

Shift the result right one bit position: 
91191 


The next bit of the multiplier is zero, so $999 is added to the result, and it 
is again shifted right: 


Ogtig1 
The next bit is again zero: 
Ooe1ig1 


The final bit is 1, so 1191 is added to the result, and the final shift is 
performed: 


01110191 


Notice that for 4-bit multiplication, four shifts are required. 8-bit 
multiplication will require eight shifts, 16-bit multiplication 16 shifts, 
and so on, 


To put the above routine into practice on the 6592, the shift and rotate 
instructions are used, Here is a program to multiply two 8-bit numbers: 


1p DIM O% 199 
29 FOR I=§ TO 3 STEP 3 


39 P% = a% 

ag [OPT | 

59 .Start CLD 

69 LDA #9 

79 STA &72 \ Clear 16-bits 

BE STA &73 \ for the result. 

96 LDY #8 \ Set Y to 8 as a counter. 
199 .Loop LSR &71 \ Shift multiplier right one bit. 
119 BCC NoAdd \ Test this bit. Branch if zero. 


129 CLC \ Clear carry prior to addition. 
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139 LDA &79 \ Load accumulator with number to be 
\ multiplied. 

149 ADC &73 \ Add most significant byte of result. 

15@ STA &73 \ Store in most significant byte of result. 

169 .NoAdd ROR &73 \ Shift result right, with carry 

178 ROR &72 \ from addition. 

189 DEY \ Decrement counter. 

199 BNE Loop \ Repeat if not zero. 

299 RTS 

219 ] 

229 NEXT 


239 INPUT “First number “one 

249 INPUT “Second number “two% 

259 2878 = one’ 

269 7&71 = two% 

276 CALL Start 

289 Product’ = 7&72 + 256*7&73 

299 PRINT “Product of two numbers is “;Product’ 


This routine is not the most efficient way of multiplying two bytes 
together, but it illustrates the method clearly: 


Lines 6G, 79 and 89 clear the two bytes in memory which will be used for 
the result of the multiplication. These locations are &72 (result low byte) 
and &73 (result high byte). 


Lines 25 and 266 store the numbers to be multiplied in locations &7¢ 
and &71. It doesn’t matter which of these is chosen to be the multiplier; 
the example uses the number in &71. 


Line 99 sets the Y register to 8 as a counter. Because this is an 8-bit 
multiplication, eight shifts are required. 


Line 190 shifts the multiplier right one bit position. The rightmost bit 
falls into the carry where it can be tested. 


Line 119 carries out the test. If the C bit is zero then the program 
branches to NoAdd; if itis 1 then the addition of the number in &79 to the 
result high byte (&73) takes place. 


Lines 12% to 159 accomplish this addition, by clearing the carry bit, 
loading the accumulator from &7@, adding the result high byte, and then 
storing back in the result high byte. 


Line 169, labelled NoAdd, rotates the result high byte right one bit 
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position. The carry from the addition in line 149 is entered from the left, 
and the rightmost bit falls into the carry. 


Line 179 rotates the result low byte right one bit position. The leftmost 
bit from the high byte, now in the carry, enters the low byte from the left. 


Line 199 decrements the counter, and repeats the above process until 
the counter is zero. 


The program will give the result of multiplying two positive integers, 
each between and 255. You can see how many instructions it takes just 
to do this, and can imagine the complexity of a BASIC statement when it 
is interpreted into machine-code. 


A shorter routine to multiply two bytes uses the accumulator as the 
result high byte, and the multiplier as the result low byte. As each bit of 
the multiplier is shifted into the carry to be tested, the leftmost bit of the 
multiplier location becomes vacant, so allowing the result to be shifted 
in. 


Start CLD 
LDA #9 \ Clear result high byte. 
LOY #8 \ Set shift counter. 


-Loop ROR &71 \ Shift multiplier right one bit. 
BCC NoAdd = \ Test this bit. Branch if zero. 
CLC \ Clear carry prior to addition. 
ADC &79 \ Add number to be multiplied. 
-NoAdd ROR A \ Shift result right, with carry from addition. 
DEY \ Decrement counter. 


BNE Loop \ Repeat if not zero. 
ROR &71 \ Final shift of result. 
STA &72 \ Store result high byte. 
RTS 


Before using this routine, the two bytes to be multiplied are placed in 
locations &74 and &71. The result appears in &71 (low byte) and &72 
(high byte). 


To multiply two 4-byte numbers together, the additions and shifts must 
act on each byte in turn, and the total number of shifts must be 32. 


Start CLD 
LOX #8 \ Clear 
LDA #9 \eight 
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Clear STA &77,X _—\ bytes 
DEX \ for 
BNE Clear \ result. 
LDY #32 \ Set shift counter. 
Loop LSR &77 \ Shift four bytes 
ROR &76 \ of multiplier 
ROR &75 \ right 
ROR &74 \ one bit. 
BCC NoAdd  \ Test this bit. Branch if zero. 
CLC \ Clear carry prior to addition. 
LDA &79 \ Add 
ADC &7C \ 4-byte 
STA &7C \ multiplier 
LDA &71 \to 
ADC &7D = \ 4-byte 
STA 87D \ result 
LDA &72 \ and 
ADC &7E \ store. 


STA &7E A 
LDA &73 \" 
ADC &7F Aa 
STA &7F Xe 

-NoAdd LOX #8 \ Shift 

Shift ROR &77,X _\ eight bytes 
DEX \ of rasult 
BNE Shift \ right 
DEY \one bit, 
BNE Loop \ Repeat if not zero 
RTS 


Before using this routine, the two numbers to be multiplied must be 
placed in !&7§ and !&74. The result appears in the four bytes from &78 
(least significant) to &7B (most significant), and is accessed as !&78. This 
routine will work with both positive and negative integers. 


Division 

Division is accomplished as the reverse of multiplication. 8-bit 
multiplication gave a 16-bit result, so, for division, a 16-bit numerator 
and 8-bit denominator will give an 8-bit result. The numerator is stored 
in two bytes of memory. It is shifted left one bit position and the 
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numerator high byte is then loaded into the accumulator. If the shift 
produced a carry then a 1 is shifted left into the result, the denominator is 
subtracted from the accumulator, and the accumulator contents are then 
stored in the numerator high byte. If the shift did not produce a carry 
then the denominator is subtracted from the accumulator in any case. If 
this subtraction produces a carry then a 1 is shifted left into the result 
and the accumulator contents are stored in the numerator high byte. If no 
carry, then @ is shifted left into the result. 


This whole process is repeated eight times. The division program is as 
follows: 


1g DIM Q% 199 
29 FOR I= TO 3 STEP 3 


39 P% = 0% 

4g [OPTI 

5@ Start CLD 

69 LDY #8 \ Set shift counter. 

79 .Loop ASL &72 \ Shift numerator 

89 ROL &73 \ left one bit. 

99 LDA &73 \ Load accumulator high byte. 
199 BCC Label \ Test carry produced by shift. 
119 SBC &71 \ Subtract denominator and 
129 STA &73 \ store in numerator high byte. 
139 SEC \ Set carry prior to shifting into result. 
149 JMP Shift \ Go to Shift. 

159 .Label SEC \ Set carry prior to subtraction. 
169 SBC &71 \ Subtract denominator 

179 BCC Shitt \ and test carry. 

189 STA &73 \ Store in numerator high byte. 
198 Shift ROL &79 \ Shift either § or 1 into result. 
20@ DEY \ Decrement counter. 

219 BNE Loop \ Repeat if not zero. 

229 RTS 

239 | 

249 NEXT 


259 iNPUT “Numerator “numerator 

269 INPUT “Denominator “denominator®% 

278 P% = &71 

289 [OPT 3 

299 EQUB denominator% \ Store denominator at location &71 

399 EQUW numerator% \ Store numerator at locations &72 and &73 
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319 RTS 

329 | 

339 CALL Start 

349 PRINT "Quotient is “;7&79 
358 PRINT “Remainder is ":?873 


In this routine, the denominator is stored at location &71, and the 
numerator in two bytes &72 and &73. The result appears in &79, and any 
remainder is left in &73. Remember, this is a 16-bit by 8-bit division, so 
the denominator may not be greater than 255 and the numerator not 
greater than 65925 (2557) to give a valid result (the result must be 255 or 
less). 


The short routine from lines 28 to 329 is used to store the data in 
memory, and contains some instructions which you have not yet seen or 
used. EQUB and EQUW are in the same class of instruction as OPT, in that 
they are used in the Assembly Language part of the program but are not 
assembly instructions. They are used simply to store data at the 
location(s) at which they appear when assembled into machine-code. 
You will see this clearly when you RUN the above program. After you 
have typed in the numerator and denominator you will see a listing of the 
machine-code from &#971 to &$974. 


There are in fact four EQU instructions: 


EQUB stores a byte of data. 

EQUW stores a word of data (2 bytes). 

EQUD stores a double-word of data (4 bytes). 
EQUS stores the ASCII representation of a string. 


EQUS is illustrated in the next section on error handling in Assembly 
Language. 


Notice in the program example above how putting P% equal to &71 
enables the denominator to be stored in &71 using EQUB, and the 
numerator to be stored in &72 and &73 using EQUW. EQUD may be used 
to store the contents of a full BASIC integer variable. (You may use EQUB 
instead of ?, and EQUD instead of !.) 


Error trapping in assembler 


The assembler will tell you of any mistakes which you make in typing in 
programs (syntax errors), and some errors associated with BASIC 
variables during assembly, but there is no such thing as a run-time error 
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in machine-code: you just have to fathom it out line by line. However, itis 
possible for you to trap errors generated while a machine-code program 
is running by using the BRK instruction. As an example, take the division 
program described in the previous section. Everyone knows that it is not 
possible to divide by zero, but the program does not know this. If you try 
to do so it unwittingly gives the answer 255. 


It is simple to test the denominator before the division is started, and 
then to branch to an error routine. The whole program is not repeated 
here, but the following lines may be added: 


53 LDA &71 
56 BEQ Error 


222 .Error BRK 

224 EQUB 18 

226 EQUS “Division by zero” 
228 BRK 


If you now run the program with a zero denominator, it will stop and print 
the message: 


Division by zero at line 339 


You can also type 


PRINT ERR Gilad 


upon which it will give the correct error number, 18. 


Any error message must take the following form: 


BRK 

EQUB errornumber (ERR) 
EQUS “message” 

BRK 


Operating system calls from assembler 


All the operating system calls available from BASIC, and many more, are 
available from a machine-code program. These routines are always 
accessed using a JSR to some address in the operating system, and 
usually involve the passing of one or more parameters via the 
accumulator (for 1), X and Y (for 2 or 3), or a parameter block in memory 


(for more than 3). 
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Here is a table showing all the operating system calls available. 


Routine Vector 
Name Address Name Address 

OSFIND FFCE 21C 
OSBPUT FFD4 218 
OSBGET | FFD7 216 
OSARGS FFDA 214 
OSFILE FFDD 212 
OSRDCH | FFEO 21¢ 
OSASCI FFE3 - 

OSNEWL | FFE7 7 

OSWRCH | FFEE 2GE 
OSWORD | FFF1 29C 
OSBYTE FFF4 290A 
OSCLI FFF7 298 


User print routine 
Event interrupt 
File system control 
entry 

Open or close a file 
Save a single byte to 
file from A 

Load a single byte to 
A from file 

Load or save data 
about a file 

Load or save a 
complete file 

Read character (from 
keyboard) to A 

Write a character (to 
screen) from A plus 
LF if (A)=&#D 
Write LF,CR (&@A, 
&@D) to screen 
Write character (to 
screen) from A 
Perform miscellaneous 
OS operation using 
control block to pass 
parameters 

Perform miscellaneous 
OS operation using 
registers to pass 
parameters 

Interpret the 
command line given 
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When you use one of these routines, you must use a JSR to the 
corresponding address shown in the second column. For example, 
OSWRCH is called from assembler by typing: 


JSR &FFEE 


The routine stored at &FFEE uses the OSWRCH vector address, shown in 
the fourth column, as an indirect pointer to the actual location of the 
OSWRCH routine. 


The reason for this is twofold: 


(i) The actual address of the OSWRCH routine may be altered by the 
manufacturer without affecting the operating system subroutine call in 
any way. JSR &FFEE will always give an OSWRCH call even though the 
address held in locations &29E and &2@F may not be the same on every 
machine. 


(ii) The user can alter the address held in the zero-page vector location 
and trap any call of that particular operating system routine, indirecting 
such a call to the user’s own routine anywhere in memory. 


Use of operating system calls 


OSWRCH entry: &FFEE vector: &20E 
This call writes the character whose ASCII code is in the accumulator to 
the screen. 


Here is an example which will print the character L on the screen: 


19 PX = &79 

29 [OPT 3 

39 .Start LDA #76 =©\ Load accumulator with ASCII code for L 
49 JSR &FFEE \ Jump to.OSWRCH 

59 RTS 

68 ] 

70 CALL Start 


OSWRCH is also used with ASCII control codes (from @ to 31). If you 
change line 3¢ to: 


39 Start LDA #7 
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then the program will output ASCII character 7, which is a ‘beep’. 


Some BASIC instructions have ASCII values in the control code range, 
and these can therefore be used with OSWRCH. For example, PLOT has 
an ASCII value of 25, TAB an ASCII value of 31. 


The following program uses TAB to print the character L half way across 
the screen: 


1p P% = &79 
29 [OPT 2 

30 Start LDA #31 
49 JSR &FFEE 
5@ LDA #19 
69 JSR &FFEE 
79 LDA #VPOS 
89 JSR &FFEE 
99 LDA #76 
199 JSR &FFEE 
119 RTS 

129 ] 

139 CALL Start 


Each parameter is passed in turn to OSWRCH via the accumulator. The 
BASIC statement equivalent to the above program is: 


PRINT TAB(19);"L"; 


(Note that this program will not work with OPT 3 because VPOS is 
affected.) 


The BASIC instruction PLOT takes three parameters, PLOT A,X.Y. 
However, X may be 9 to 1279 and Y may be § to 1623, so each must be 
represented by two bytes, That means that an OSWRCH call with the 
accumulator set to 25 must be followed by five more OSWRCH calls to 
pass the parameters. The following program will plot a line on the screen: 


19 MODE 4 

29 P% = G78 

39 [OPT 3 

4g Start LDA #25 
5@ JSR &FFEE 
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69 LDA #5 

79 JSR &FFEE 
89 LDA #88 
$9 JSR &FFEE 
199 LDA #2 
119 JSR &FFEE 
129 LOA #44 
139 JSR &FFEE 
149 LDA #1 
159 JSR &FFEE 
169 RTS 

179 ] 

189 CALL Start 


This program is equivalent to 
PLOTS,699,300 


Lines 169 and 8@ give X (2*256 + 88) and lines 149 and 129 give Y 
(1*256 + 44). 


You'll see from the listing that the above routine, when assembled, 
occupies memory from &79 to &8E. Remember that user programs must 
use zero-page locations only between &79 and &8F, so this is almost the 
largest size routine that may be stored in the zero-page. 


OSASCI entry: &FFE3 

Writes the character whose code is in the accumulator to the screen using 
OSWRCH. However, if the accumulator contains &D then OSNEWL is 
called instead. The actual code at location &FFE3 is: 


-OSASCI CMP #&D 
BNE OSWRCH 

-OSNEWL LDA #&A 
JSR OSWRCH 
LDA #&D 

<OSWRCH = JMP (WRCHV) 


OSNEWL entry: & FFE7 
This call issues a line feed/carriage return to the screen, as shown above. 
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After using OSWRCH, OSASCI, or OSNEWL, the contents of the 
accumulator, X, and Y registers are unchanged. Flags C, N, V, and Z are 
undefined, and D = @. 


OSRDCH entry: &FFEQ vector: &216 
This call reads a character code from the keyboard into the accumulator. 


After using OSRDCH, the contents of the X and Y registers are 

unchanged. Flags N, V, and Z are undefined, and D = @. Flag C tells 

whether the read has been successful (C = 9). If C = 1 then an error has 

occurred and the error number is given in the accumulator. If C = 1 andA 

= &1B then an escape condition has been detected and you must 

acknowledge this by performing an OSBYTE call with A = &7E, or 
FX126. 


OSCLI entry: &FFF7 vector: &208 

This call is used by the BASIC OSCLI instruction. From assembler it 
consists of a JSR to &FFF7, the command line string being placed in 
memory at a location given by the contents of the X register (address low 
byte) and Y register (address high byte). The command line string must 
be terminated by &D RETURN 


The following BASIC program illustrates this: 


19 DIM address 29 

29 keynumber = 4 

30 $address = “KEY’+STRS$ keynumber+” “LIST! MI" 
4g X% = address MOD 256 

59 Y% = address DIV 256 

68 CALL &FFF7 


This will have the same effect as 
*KEYA"LIST IM” 


Note: The string indirection operator $ automatically puts a [jai 

code (&D) after the string. EQUS however does not, and it must be 
inserted afterwards using EQUB &D or something like EQUS “FRED” + 
CHRS13. 
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OSFIND entry: &FFCE vector: &21C 


Opens a file from cassette or disc for reading or writing. The contents of 
the accumulator determine the operation performed: 


A=9 closes a file or files (CLOSE#). 

A= &49 opens a file for input (OPENIN). 

A= &89 opens a file for output (OPENOUT). 

A= &C# opens a file for input or output (OPENUP). 


When OPENIN, OPENOUT, or OPENUP is used, X and Y must contain the 
address of the filename. After the subroutine call, the accumulator will 
contain the channel number allocated to that file by the operating 
system. 


If CLOSE# is used then Y must contain the channel number of the file to 
be closed. If Y is then all files will be closed. 


OSBPUT entry: &FFD4 vector: &218 

Writes the byte contained in the accumulator to the cassette or disc file 
(same as BPUT#). Y must contain the file channel number. After using 
OSBPUT, the contents of the accumulator, X, and Y registers are 
unchanged. 


OSBGET entry: &FFD7 vector: &216 

Reads a byte from the cassette or disc file into the accumulator (same as 
BGET#). Y must contain the file channel number. After using OSBGET, 

the contents of the X and Y registers are unchanged. Flags N, V, and Z 
are undefined, and D = 9. Flag C tells whether the read has been 
successful (C = @). If C = 1 then an error has occurred and the error 
number is given in the accumulator. If C = 1 and A = &FE then the end of 
file has been reached. 


OSFILE entry: &FFDD vector: &212 

Allows a whole file to be loaded or saved. The contents of the 
accumulator indicate the function to be performed. X and Y point to an 
18 byte control block anywhere in memory, the structure of which is as 
follows: 


OSFILE control block 


00 Address of file name, which must be terminated LSB 
gl by &#D MSB 
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G2 Load address of file LSB 

63 

4 

05 MSB 

96 Execution address of file LSB 

67 

68 

99 MSB 

GA Start address of data for write operations, LSB 

0B or length of file for read operations 

6c 

@D MSB 

GE End address of data, that is byte after LSB 

OF last byte to be written or file attributes 

19 

li MSB 

a a ee 

The table below indicates the function performed by OSFILE for each 

value of A. 

A=§ Save a section of memory as anamed file. The file’s catalogue 
information is also written. 

A=1 Write the catalogue information for the named file. 

A=2 Write the load address (only) for the named file. 

A=3 Write the execution address (only) for the named file. 

A=4 Write the attributes (only) for the named file. 

A=5 Read the named file’s catalogue information. Place the file 
type in A. 

A=6 Delete the named file. 

A=&FF Load the named file and read the named file’s catalogue 


information. 


Note: Values 1 to 6 are not available on a cassette filing system. 


OSBYTE entry: &FFF4 vector: &20A 

This is a family of operating system calls which includes all the *FX calls 
available from BASIC. (These are not repeated here.) The call number is 
passed in the accumulator and parameters are passed in X or Y or both. 
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at OSBYTE calls are available from BASIC via a USR call, or by using a 
FX call. 


Here is a list of functions as given by each accumulator value (A): 


A= 127 (E0F#) *FX127 


Gives the end of file status of a previously opened file. X must contain the 
file channel number. Afterwards, X will be zero if the end of file has not 
been reached, non-zero if the end of file has been reached. 


A = 129 (INKEY) *FX129 


Either waits for a character from the keyboard buffer until a time limit 
expires (INKEYpositive) or tests if a key is depressed (INKEYnegative). 
All the discussion about auto-repeat and buffer flushing applies to this 
call. 


For INKEYpositive, Y must contain the most significant byte of the delay, 
and X the least significant (in hundredths of a second). 


Afterwards, if Y = % then a character has been detected and its code 
appears in X. Y = &1B indicates that | ESCAPE | was pressed and must be 
acknowledged with *FX126. Y = &FF indicates that no key was pressed 
in the allocated time. 


For INKEYnegative, Y must contain the requisite key-code in twos 
complement. Afterwards Y will be either TRUE (&FF) or FALSE (zero) 
depending on whether the key was pressed. 

A= 131 (OSHWM) *FX131 


Gives the address of the first free location in memory above that required 
for the operating system. Usually equal to &E@@. The address is given in 
X (low byte) and Y (high byte). For example, after *FX29,6. 

A= 132 *FX132 
Gives the lowest memory address used by the screen display in X (low 
byte) and Y (high byte). 

A = 183 Low mode address ¥FX133 


Gives the lowest address in memory used by a particular mode. Does not 
change mode but merely investigates the consequences of doing so. The 
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mode to be investigated must be in X. Afterwards, the address is 
contained in X (low byte) and Y (high byte). 


A = 134 Read position of text cursor *FX134 


Gives in X the X coordinate of the text cursor, and in Y the Y coordinate 
(same as POS and VPOS). 


A = 135 Read character at position of text cursor *FX135 


Gives in X the ASCII code of the character at the current text cursor 
position, and in Y the current mode number. X is 9 if the character is not 
recognisable. 


Here is a BASIC function which can be used to read the character at any 
position X,Y on the screen: 


1999 DEF FNreadcharacter(column%,row%) 

119@ LOCAL A%,currentX%,currentY%, character” 

1299 currentX% = POS: currentY% = VPOS 

1399 VDU31,column%,row% 

1499 A% = 135 

159@ character% = (USR(&FFF4) AND &FF@@) DIV &199 
1799 VDU31,currentX%,currentY% 

1896 = CHRS character% 


To give the character at position X,Y this function would be called by 
passing X and Y as the two parameters: 


PRINT FNreadcharacter(X,Y) 


A = 187 Motor control *FX137 


Similar to *MOTOR. X = @ will turn off the cassette motor, X = 1 will turn 
it on. 


A= 139 (*OPT) *FX138 
Exactly the same as *OPT. The parameters are passed in X and Y. 
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A = 145 Get character from keyboard buffer *FX145 


Reads a character code from a buffer into the Y register. X = buffer 
number (@ to 9 inclusive). C = § indicates a successful read, C = 1 
indicates that the buffer is empty. 


A = 218 Cancel VDU queue ¥*FX218 


Many VDU codes expect a sequence of bytes (as shown earlier with PLOT 
and TAB). This call signals the VDU software to throw away the bytes it 
has received so far. Before use, X and Y must contain zero. 


OSWORD entry: &FFF1 vector: &206C 

This is a family of operating system calls which uses a parameter block 
somewhere in memory to supply data to the routine and to receive results 
from it. The exact location of the parameter block must be specified in X 
(low byte) and Y (high byte). The accumulator contents determine the 
action of the OSWORD call. 


A= @ Read a line from keyboard to memory 


Accepts characters from the keyboard and places them at a specified 
location in memory. During input the DELETE] key (ASCII 127) deletes 
the last character entered, and U (ASCII 21) deletes the entire 
line. The routine ends if is entered (ASCII 13) or the 

key is pressed. 


The control block contains five bytes: 


YX (low byte) Address at which 
YX+1 (high byte) line is to be stored 
YX+2 Maximum length of line 

YX+3 Minimum acceptable ASCTI value 
YX+4 Maximum acceptable ASCII value 


Characters will only be entered if they are in the range specified by 
YX+3 and YX+4., 


Afterwards, C = @ indicates that the line was terminated by a [Jai 
C not equal to zero indicates that the line was terminated by an 


. Yis set to the length of the line, excluding the carriage return if 
C= G. 
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A= 1 Read clock 


Reads the internal elapsed-time clock into the five bytes pointed to by X 
and Y. The clock is incremented every hundredth of a second, and is used 
by the BASIC variable TIME. 


A = 2 Write clock 


Sets the internal elapsed-time clock to the value given in the five bytes 
pointed to by X and Y. Location YX is the least significant byte of the 
clock, YX+4 is the most significant. 


A= 3 Read interval timer 


In addition to the clock there is an interval timer which is also 
incremented every hundredth of a second. The interval is stored in five 
bytes pointed to by X and Y. See OSWORD with A = 1. 


A = 4 Write interval timer 


X and Y point to five bytes which contain the new value to which the 
clock is to be set. The interval timer may cause an event when it reaches 
zero, Thus setting the timer to &FFFFFFFFFD would cause an event 
after three hundredths of a second. 


A=7 SOUND 


Equivalent to the BASIC SOUND statement. The eight bytes pointed to 
by X and Y contain the four two-byte parameters (in fact only the least 
significant byte of each need be used). 


YX Q (channel, 6 to 3) 

YX+1 = zero 

YX+2 A (envelope, -15 to 4) 

YX+3 zero, or &FF if -1 or some other negative value 
YX+4 =P (pitch, @ to 255) 


YX+5 zero 
YX+6  D (duration, 1 to 255) 
YX+7 zero 


A = 8 ENVELOPE 


Equivalent to the BASIC ENVELOPE statement. X and Y point to 14 
bytes of data which are the 14 parameters used by ENVELOPE. 
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A=9 POINT 


Equivalent to BASIC POINT function. The parameter block pointed to 
by X and Y must be set up as follows: 


YX =X (low byte) coordinate 
YX+1 X (high byte) coordinate 
YX+2 Y (low byte) coordinate 
YX+3 Y (high byte) coordinate 


Afterwards, YX+4 will contain the logical colour value of that particular 
graphics coordinate. If the coordinate is off the screen then YX+4 
contains &FF, 


A = 19 Read character definition 


Characters are displayed on the screen as an 8X8 matrix of dots. The 
pattern of dots for each character, including user-defined characters, is 
stored as eight bytes. This call enables the eight bytes to be read into a 
block of memory starting at the address given in X and Y, plus 1. The 
ASCII code of the character must be the first entry on the parameter 
block when the routine is called. 


Afterwards, the parameter block contains data as shown below: 


YX Character code 
YX+1 Top row of displayed character 
YX+2 Second row of displayed character 


YX+8 Bottom row of displayed character 


Here is a program to illustrate this OSWORD call, and the method of 
calling OSWORDs in general. It takes each of the characters in turn, 
reads the matrix definition, and then reverses this definition by shifting 
the bits in each byte, and then redefining each character using VDU23. 
The result makes your program interesting to read, to say the least! 


19 MODE 6 

29 DIM Q% 199 

39 FOR I=@ TO 3 STEP 3 

4g P% = Q% 

59 [OPT | 

69 .Character LDA &691 \ Take low address of parameter 
768 STA &79 \ and store it in zero-page. 


89 LDA &692 
968 STA &71 

199 LDY #9 
119 LDA (&79),Y 
129 STA &79 
139 LOX #879 


149 LDA #19 

150 JSR &FFFI 

169 LDX #9 

179 .Reverse LDY #8 
189 .Loop ASL &71,X 
198 ROR &79,X 
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\ Take high address of parameter 
\ and store it in zero-page. 

\ Clear Y register. 

\ Get parameter (ASCII code) 

\ and store it in zero-page. 


\ Set X to OSWORD parameter block address low 


\ byte. 

\ Set OSWORD function. 

\ Jump to OSWORD. 

\ Clear X register. 

\ Set Y to 8 as shift counter. 
\ Shift each byte into the byte 
\ helow, thereby reversing it. 


2998 DEY \ Decrement Y. 

219 BNE Loop \ Repeat if not zero. 
228 INX \ Increment X. 

238 CPX #8 \ Compare with 8. 
249 BNE Reverse \ Repeat if not equal. 
259 RTS 

269 ] 

279 NEXT 

289 *FX29,6 


299 FOR 1%=33 TO 126 

399 PRINT CHRS 1%; 

316 CALL Character,I% 

328 VDU23, 1%,2&77,2876,7&75,27&74,72&73,7872,7&7 11,2878 
339 NEXT 


This program illustrates a number of the features demonstrated in this 
part of the book. It calls the machine-code routine Character with a para- 
meter, and lines 69 to 129 transfer the parameter to location &79, which 
is a safe place at which to store any OSWORD data. 


Line 134 sets X to the low byte of the address of the OSWORD 
parameter block (it is not necessary to set Y because Y is already zero). 


Lines 146 and 15¢ carry out the OSWORD call. 
Lines 169 to 249 reverse each of the bytes of the character definition. 


Line 289 explodes the character memory allocation to its maximum, 
allowing all the characters to be redefined, and line 326 carries out this 
redefinition. 
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It should be noted that if this program were more than &399 bytes long, it 
would get overwritten by the soft characters. 


A = 11 Read colour assigned to logical value 


Gives the actual colour value assigned to the logical colour value 
contained in the location pointed to by X and Y. Afterwards, location YX 
will contain the logical value, and location YX+1 will contain the actual 
value. In fact YX+1 to YX+4 contain the four-byte physical colour— you 
must reserve space for five bytes. 


Events 


Events are conditions which occur within the computer and which can be 
trapped by the user so as to provide useful information. For example, itis 
possible to detect when the keyboard buffer is full, or when has 
been pressed. 


To be able to act upon an event, that event must first be enabled by 
¥*EX14: 


*FX14,9 enables output buffer empty event. 

*FX14,1 enables input buffer full event. 

*FX14,2 enables character entering keyboard buffer event. 

*FX14,4 enables start of vertical synchronisation of screen display event. 
*£X14,5 enables the interval timer crossing zero event. 

*FX14,6 enables Eig pressed event. 


The operating system detects all the above events when they occur, but 
ignores them if they have not been enabled with the appropriate *FX14 
call. If an event occurs which has been enabled then program execution 
indirects via &22@ and places an event code (shown below) in the 
accumulator. The contents of X and Y may also depend upon the event. 


The event codes are as follows: 


A=9 Output buffer empty. (X contains buffer identity.) 
1 Input buffer full. (X contains buffer identity, Y contains the 
ASCII code of character that could not be stored in buffer.) 
Key pressed. 
Vertical synchronisation of screen display. 
Interval timer crossing zero. 

detected. 


i ll 


tl 


>> Pr> b> 
ll 
Oanwn 
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Any address may be stored in the two bytes &229 and &221 to which the 
program will transfer execution on detection of an enabled event. You 
may write your own code at this address in order to process the event, but 
it must be terminated by RTS, and should not take too long (one 
millisecond maximum). 


Each of the events may be disabled by a corresponding *FX13. For 
example, *FX13,1 will disable the input buffer full event. 


Assembly Language mnemonics 


This section describes, in alphabetical order, all the 6542 assembler 
mnemonics. 


The following abbreviations are used: 


A accumulator 

».¢ index register X 

Y index register Y 

F flags register 

PC program counter 

PCH program counter (high byte) 
PCL program counter (low byte) 
SP stack pointer 

M memory address 

- ‘becomes’ (assignment) 

= ‘affects’ (flags) 

() contents of 

& hexadecimal 


(A4) 
(M7) pete specified bit position in register or memory 


status flags 


Because this section has been written for use with the Electron’s 
assembler, the addressing modes quoted are simplified as compared 
with those that are specified for use with general machine-code program- 
ming of the 6592. 
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ADC 


Action 


Description 


Addressing modes 


Flags affected 


Comments 


AND 


Action 


Description 


Addressing modes 


Flags affected 


Comments 


ASL 


Action 


Add with carry 


A (A)+data+C 


Add the contents of memory location or im- 
mediate data to the accumulator, plus the carry 
bit. Result is placed in the accumulator. 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NVZC 


To add without the carry, bit C must be cleared 
beforehand by using CLC. 


Logical AND 


A-~ (A) AND data 


AND the contents of memory location or im- 
mediate data with the accumulator. Result is 
placed in the accumulator. 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NZ 
See BASIC AND for truth table. 


Arithmetic shift left 


C~«+AorM<+@ 


Description 


Addressing modes 


Flags affected 


Comments 


BCC 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


BCS 


Action 


Description 


Addressing modes 
Flags affected 


Comments 
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Shift the contents of the accumulator or memory 
location left one bit position. Bit 7 falls into the 
carry (bit C), zero is entered from the right. Result 
remains in either the accumulator or the memory 
location. 


Zero-page 
Absolute 
Indexed (X only) 
Accumulator 


NZC 
ASL A acts on the accumulator. 


Branch if carry clear 


Go to specified label or address if C = @ 


If bit C is zero, execution continues at the spec- 
ified label or address. If bit C is 1 then execution 
continues at the next instruction. 


Relative 
None 


Specified label or address must be in range. 


Branch if carry set 


Go to specified label or address if C = 1 


Tf bit C is 1, execution continues at the specified 
label or address. If bit C is zero then execution 
continues at the next instruction. 


Relative 
None 


Specified label or address must be in range. 
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BEQ 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


BIT 


Action 


Description 


Addressing modes 


Flags affected 


BMI 


Action 


Description 


Addressing modes 


Branch if equal to zero 


Go to specified label or address if Z = 1 


If bit Z is 1, execution continues at the specified 
label or address. If bit Z is zero then execution 
continues at the next instruction. 


Relative 
None 


Specified label or address must be in range. 


Compare memory bits with accumulator 


(A) 
m7 F 


The accumulator is compared with the contents of 
amemory location. If the two are the same then bit 
Z is set to 1; ifnot then bit Z is cleared. Bits 6 and7 
of the data from memory are loaded into bits V and 
N respectively. The contents of the accumulator 
remain unchanged. 


Absolute 
Zero-page 


NVZ 


Branch if minus 


Go to specified label or address if N = 1 


If bit N is 1, execution continues at the specified 
label or address. If bit N is zero then execution 
continues at the next instruction. 


Relative 


Flags affected 


Comments 


BNE 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


BPL 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


BRK 


Action 
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None 


Specified label or address must be in range. 


Branch if not equal to zero 


Go to specified label or address if Z = @ 


If bit Z is zero, execution continues at the specified 
label or address. If bit Z is 1 then execution 
continues at the next instruction. 


Relative 
None 


Specified label or address must be in range. 


Branch if plus 


Go to specified label or address if N= 0 


If bit N is zero, execution continues at the speci- 
fied label or address. If bit N is 1 then execution 
continues at the next instruction. 


Relative 
None 


Specified label or address must be in range. 


Break 


STACK = (PC)+2 
STACK = (F) 
PCL + (&FFFE) 
PCH = (&FFFF) 
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Description 


Addressing modes 
Flags affected 


Comments 


BVC 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


BVS 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


This is a software interrupt. The contents of the 
program counter plus 2 are pushed on the stack, 
followed by the contents of the flags register. The 
program counter is then loaded with the contents 
of locations &FFFE (low byte) and &FFFF (high 
byte). Bit B is set to 1. 


Implied 
B 
Used mainly for error trapping and debugging. 


Branch if overflow clear 


Go to specified label or address if V = @ 


Tf bit V is zero, execution continues at the specified 
label or address. If bit V is 1 then execution 
continues at the next instruction. 


Relative 
None 


Specified label or address must be in range. 


Branch if overflow set 


Go to specified label or address if V = 1 


Tf bit V is 1, execution continues at the specified 
label or address. If bit V is zero then execution 
continues at the next instruction. 


Relative 
None 


Specified label or address must be in range. 


CLC 


Action 
Description 
Addressing modes 
Flags affected 


Comments 


CLD 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


CLI 


Action 
Description 
Addressing modes 
Flags affected 


Comments 


Assembly Language 249 


Clear carry 
C+9G 
Bit C is cleared. 
Implied 
Cc 
Often required before ADC. 


Clear decimal flag 


D+9 


Bit D is cleared, which means that the processor is 
in binary mode. 


Implied 
D 


Should be used at the beginning of all routines 
which do not use binary coded decimal. 


Clear interrupt mask 
I+@ 
Bit I is cleared, which enables interrupts. 
Implied 
I 


An interrupt is triggered when an external device, 
such as a printer, requires attention. 
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CLV 


Action 
Description 
Addressing modes 
Flags affected 


CMP 


Action 


Description 


Addressing modes 


Flags affected 


CPX 


Action 


Description 


Clear overflow flag 


V+ 

Bit V is cleared. 
Implied 

v 


Compare with accumulator 


(A)-data > F 


Contents of memory location or immediate data 
are subtracted from the accumulator. If the result 
is zero then bit Z is set; if not zero it is cleared. If 
the result is negative then bit N is set; if positive it 
is cleared. Bit C is set if the accumulator contents 
are greater than or equal to the data. The contents 
of the accumulator remain unchanged; only the 
flags register is affected. 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NZC 


Compare with X register 


(X)-data > F 


Contents of memory location or immediate data 
are subtracted from the X register. If the result is 
zero then bit Z is set; if not zero it is cleared. If the 
result is negative then bit N is set; if positive it is 
cleared. Bit C is set if the X register contents are 


Addressing modes 


Flags affected 


CPY 


Action 


Description 


Addressing modes 


Flags affected 


DEC 


Action 


Description 
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greater than or equal to the data. The contents of 
the X register remain unchanged; only the flags 
register is affected. 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NZC 


Compare with Y register 


(Y)-data > F 


Contents of memory location or immediate data 
are subtracted from the Y register. If the result is 
zero then bit Z is set; if not zero it is cleared. If the 
result is negative then bit N is set; if positive it is 
cleared. Bit C is set if the Y register contents are 
greater than or equal to the data. The contents of 
the Y register remain unchanged; only the flags 
register is affected. 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NZC 


Decrement memory 


M~+(M)-1 


The contents of the specified memory location are 
decremented by 1. 
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Addressing modes 


Flags affected 


DEX 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


DEY 
Action 


Description 


Addressing modes 
Flags affected 


Comments 


EOR 


Action 


Description 


Zero-page 
Absolute 
Indexed (X only) 


NZ 


Decrement X register 


X= (X)-1 


The contents of the X register are decremented by 
1. 


Implied 
NZ 


Enables X to be used as a counter. 


Decrement Y register 


Y~> (Y)}-1 


The contents of the Y register are decremented 
by 1. 


Implied 
NZ 


Enables Y to be used as a counter. 


Logical exclusive-OR 


A+ (A) EOR data 


Exclusive-OR the contents of memory location or 
immediate data with the accumulator. Result is 
placed in the accumulator. 


Addressing modes 


Flags affected 


Comments 


INC 


Action 


Description 


Addressing modes 


Flags affected 


INX 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


INY 


Action 
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Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NZ 
See BASIC EOR for truth table. 


Increment memory 


M~+(M)+1 


The contents of the specified memory location are 
incremented by 1. 


Zero-page 
Absolute 
Indexed (X only) 


NZ 


Increment X register 


X= (X)4+1 


The contents of the X register are incremented by 
dy 


Implied 
NZ 


Enables X to be used as a counter. 


Increment Y register 


Y+(yY)ti 
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Description 


Addressing modes 
Flags affected 


Comments 


JMP 


Action 


Description 
Addressing modes 


Flags affected 


Comments 


JSR 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


The contents of the Y register are incremented by 
4: 


Implied 
NZ 


Enables Y to be used as a counter. 


Unconditional jump 


PC + address 


Execution continues at the specified label or 
address. 


Absolute 
Indirect 


None 


There is no restriction on length of jump; label or 
address may be anywhere in memory. This is the 
only instruction which may use straight indirect 
addressing. 


Jump to subroutine 


STACK + (PC)+2 
PC + address 


The contents of the program counter plus 2 are 
pushed on the stack (this is the address of the 
instruction following JSR). Execution continues 
at the specified label or address. 


Absolute 
None 


The subroutine to which control is transferred 
must be terminated by an RTS instruction. JSR is 


LDA 


Action 


Description 


Addressing modes 


Flags affected 


LDX 


Action 


Description 


Addressing modes 


Flags affected 


LDY 


Action 


Description 


Assembly Language 255 


used whenever you wish to make an operating 
system call from assembler. 


Load accumulator 


A data 


Load the accumulator with contents of memory 
location or immediate data. 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NZ 


Load X register 


X+ data 


Load the X register with contents of memory 
location or immediate data. 


Immediate 
Zero-page 
Absolute 
Indexed (Y only) 


NZ 


Load Y register 
Y + data 


Load the Y register with the contents of memory 
location or immediate data. 
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Addressing modes 


Flags affected 


LSR 


Action 


Description 


Addressing modes 


Flags affected 


Comments 


NOP 


Action 
Description 


Comments 


ORA 


Action 


Immediate 
Zero-page 
Absolute 
Indexed (X only) 


NZ 


Logical shift right 


@—~-AorM~C 


Shift the contents of the accumulator or memory 
location right one bit position. Bit @ falls into the 
carry (bit C), zero is entered from the left. Result 
remains in either the accumulator or memory 
location. 


Zero-page 
Absolute 
Indexed (X only) 
Accumulator 


NZC 
LSR A acts on the accumulator. 


No operation 


None 
Does nothing for two clock cycles. 


Used for timing a program, or to fill in gaps caused 
by deleted instructions. 


Logical OR 


A~ (A) OR data 


Description 


Addressing modes 


Flags affected 


Comments 


PHA 


Action 


Description 


Addressing modes 
Flags affected 


PHP 


Action 


Description 


Addressing modes 
Flags affected 
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OR the contents of memory location or immediate 
data with the accumulator. Result is placed in the 
accumulator. 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NZ 
See BASIC OR for truth table. 


Push accumulator on to stack 
STACK = (A) 
SP + (SP)-1 


The contents of the accumulator are pushed on to 
the stack. The stack pointer is decremented. The 
accumulator contents remain unchanged. 


Implied 


None 


Push flags register on to stack 
STACK + (F) 
SP = (SP)-1 


The contents of the flags register are pushed on to 
the stack. The stack pointer is decremented. The 
flags register contents remain unchanged. 


Implied 


None 
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PLA 


Action 
Description 


Addressing modes 
Flags affected 


PLP 


Action 
Description 


Addressing modes 
Flags affected 


ROL 


Action 


Description 


Addressing modes 


Flags affected 


Comments 


Pull data from stack into accumulator 
A+ (STACK) 
SP + (SP)+1 


Pull the top byte of the stack into the accumulator. 
Increment the stack pointer. 


Implied 
NZ 


Pull data from stack into flags register 
F + (STACK) 
SP = (SP)+1 


Pull the top byte of the stack into the flags register. 
Increment the stack pointer. 


Implied 
NVBDIZC 


Rotate left 


Rotate the contents of the accumulator or memory 
location left one bit position. The carry (bit C) is 
entered from the right, bit 7 falls into the carry. 
Zero-page 

Absolute 


Indexed (X only) 
Accumulator 


NZC 


ROL A acts on the accumulator. This is a 9-bit 
rotation. 


ROR 


Action 


Description 


Addressing modes 


Flags affected 


Comments 


RTI 


Action 


Description 


Addressing modes 
Flags affected 


Comments 
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Rotate right 


Rotate the contents of the accumulator or memory 
location right one bit position. The carry (bit C) is 
entered from the left, bit @ falls into the carry. 


Zero-page 
Absolute 
Indexed (X only) 
Accumulator 


NZC 


ROR A acts on the accumulator. This is a 9-bit 
rotation. 


Return from interrupt 


F + (STACK) 
SP + (SP)+1 
PCL + (STACK) 
SP + (SP)+1 
PCH = (STACK) 
SP + (SP)+1 


Restore the contents of the flags register and the 
program counter, which were previously stored on 
the stack. Increment stack pointer. 


Implied 
NVBDIZC 


Used to return to the execution of a program, after 
an interrupt has been dealt with. 
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RTS 


Action 


Description 


Addressing modes 
Flags affected 


Comments 


SBC 


Action 


Description 


Addressing modes 


Flags affected 


Comments 


Return from subroutine 


PCL = (STACK) 
SP + (SP)+1 
PCH + (STACK) 
SP + (SP)+1 
PC = (PC)+1 


Restore the contents of the program counter, 
which were previously stored on the stack, and 
increment the program counter by 1. Increment 
the stack pointer. 


Implied 
None 
Continues execution from position after sub- 


routine call. Used by the Electron’s assembler to 
return to BASIC. 


Subtract with carry 


A (A)-data-C 
(C is NOT C, which is the borrow.) 


Subtract the contents of memory location or 
immediate data from the accumulator, with bor- 
row. Result is placed in the accumulator. 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


NVZC 


To subtract without the borrow, bit C must be set 
beforehand by using SEC. 


SEC 


Action 
Description 
Addressing modes 
Flags affected 


Comments 


SED 


Action 


Description 


Addressing modes 
Flags affected 


SEI 


Action 
Description 
Addressing modes 


Flags affected 


STA 


Action 


Description 
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Set carry 
C+1 
Bit C is set. 
Implied 
Cc 
Often required before SBC. 


Set decimal flag 


D+1 


Bit D is set, which means that the processor is in 
decimal mode (BCD). 


Implied 
D 


Set interrupt mask 
[1 
Bit I is set, which disables interrupts. 
Implied 
I 


Store accumulator in memory 


M~ (A) 


Store contents of the accumulator at the specified 
memory location. The accumulator contents re- 
main unchanged. 
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Addressing modes 


Flags affected 


STX 


Action 


Description 


Addressing modes 


Flags affected 


STY 


Action 
Description 


Addressing modes 


Flags affected 


Immediate 
Zero-page 
Absolute 
Indexed 
Indirect/indexed 


None 


Store X register in memory 


M~= (X) 


Store contents of X register at the specified 
memory location. The X register contents remain 
unchanged. 


Zero-page 
Absolute 
Indexed (zero-page Y only) 
None 
Store Y register in memory 
M~+(Y) 


Store contents of Y register at the specified 
memory location. The Y register contents remain 
unchanged. 


Zero-page 
Absolute 
Indexed (zero-page X only) 


None 


TAX 


Action 


Description 


Addressing modes 
Flags affected 


TAY 


Action 


Description 


Addressing modes 
Flags affected 


TSX 


Action 


Description 


Addressing modes 
Flags affected 


TXA 


Action 
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Transfer accumulator to X 


K+ (A) 


Copy the contents of accumulator into X register. 
The accumulator contents remain unchanged. 


Implied 
NZ 


Transfer accumulator to Y 


¥~+ (A) 


Copy the contents of accumulator into Y register. 
The accumulator contents remain unchanged. 


Implied 
NZ 


Transfer stack pointer to X 


X= (SP) 


Copy the contents of the stack pointer into X 
register. The stack pointer contents remain un- 
changed. 


Implied 
NZ 


Transfer X register to accumulator 


A~(X) 
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Description 


Addressing modes 


Flags affected 


TXS 


Action 


Description 


Addressing modes 
Flags affected 


TYA 


Action 


Description 


Addressing modes 


Flags affected 


Copy the contents of the X register into the 
accumulator. The X register contents remain 
unchanged. 


Implied 
NZ 


Transfer X register to stack pointer 


S+ (X) 


Copy the contents of the X register into the stack 
pointer. The X register contents remain un- 
changed. 


Implied 
NZ 


Transfer Y register to accumulator 


A~ (¥) 


Copy the contents of the Y register into the 
accumulator. The Y register contents remain 
unchanged. 


Implied 
NZ 


Appendix A 
VDU codes 


VDU A is equivalent to PRINT CHRS A; 
VDU A,B,C is equivalent to PRINT CHR$ A; CHRS B; CHRS C; 


This chapter is a description of the whole character set from § to 255 
which can be used with either VDU or PRINT. CHRS. The ASCII table is 
in Appendix F, and you will see that codes from § to 31 give control 
characters for the screen display; codes 32 to 127 generate visual 
characters; and the remainder are initially undefined. 


Here is each code in detail: 


Code Keyboard Description 

6 @ Does nothing. 

1 CTRL Reserved. 

2 CTRL MBs] Reserved. 

3 CTRL ie Reserved. 

4 D Allows the text cursor and the 
graphics cursor to operate 
independently of one another. 
(Reverses the action of VDU 5.) 

5 CTRL Bo Causes the text cursor to be joined 


to the graphics cursor. The text 
cursor ceases to exist, and characters 
are printed at the graphics cursor 
which is positioned using MOVE. 


6 CTRL BY Allows output to be printed on the 
screen. (Reverses the action of 
VDU 21.) 

7 CTRL Be Causes a short ‘beep’ from the 


internal loudspeaker. 

Moves the text cursor back one 
space on the screen. Does not delete 
the previous character. 

I Moves the text cursor forward one 
space on the screen. 


CTRL 


fos) 

ix] 

a 

- - - 
aq 
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1g 


11 


14 


18 


19 


CTRL 


J 


Zr 


Rn BD © VO 


Moves the text cursor down one line 
on the screen. If the cursor is already 
at the bottom then the screen will 
scroll up one line. 

Moves the text cursor up one line on 
the screen. If the cursor is already at 
the top then the screen will scroll 
down one line. 

Clears the text screen. Same as CLS. 
VDU13 issued as a command (not in 
a program), or M, have 
exactly the same effect as | RETURN 
In a program, VDU13 will move 

the text cursor to the start of the 
current line. 

Puts the display into paged mode. 
Programs will only be listed to fill 
the screen, and then the computer 
will wait until the key is 
pressed before listing another screen 
full. Used when reading long 
programs. 

Cancels paged mode. (Reverses the 
action of N.) 

Clears the graphics screen. Same as 
CLG. 

Changes text colour. Same as 
COLOUR. 

Changes graphics colour, and colour 
mix. Same as GCOL. 

Assigns any logical colour value to 
any actual colour. For example, mode 
6 normally has two colours only, 
black and white, assigned the logical 
colour values @ and 1. To change ¢ 
(black) to blue, use VDU19 with the 
logical colour $, and the actual colour 
4 (blue). 


MODE 6 
vDU1S, 9, 4, 9. 9, 6 


20 Gi + 
21 Gi uv 


23 agg WwW 
24 CTRL ie 
25 CTRL eg 
26 CTRL 
27 CTRL iy 
28 CTRL 
29 CTRL ie 
30 CTRL 
31 CTRL 
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Returns all logical colours to normal. 
(Reverses VDU19). 

U deletes the whole of the 
current line being typed. 

VDU21, in a program, disables all 
output to the screen. This is reversed 
by VDU6. F 

Changes mode. VDU22,2 is 
equivalent to MODE 2, except that 
HIMEM is not altered. 

Reprograms a displayed character. 
32 user-definable characters are set 
aside for use with VDU23. All the 
rest of the characters can be 
redefined if the memory is exploded 
with *FX29,1. 

Defines a graphics window. 

Same as PLOT. VDU25,85,X.Y is the 
same as PLOT 85,X.Y. 

Reverses the effects of VDU24, 
VDU28, and VDU29. Graphics and text 
windows both occupy the whole 
screen; text origin and text cursor 
are at top left; graphics origin and 
graphics cursor are at bottom left. 
Reserved. 

Defines a text window. 

Moves the graphics origin. VDU29,X,Y 
will move @,@ to position X.Y. 
Homes text cursor to top left of text 
window. 

VDU31,X,Y is the same as PRINT 
TAB(X,Y). 


32-126 (aia SPACE to~~ The complete set of ASCII 


127 


characters. 

Moves the text cursor back one 
space on the screen and deletes the 
character to the current background 
colour. 
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128-223 Normally undefined. Can be defined 
if memory is allocated using *FX2§,1 
and VDU23. 

224-255 User-definable characters. Can be 


defined using VDU23. 


rg 


Appendix B 
Error messages 


When the computer is unable to continue executing a program or a 
command it will tell you by printing a message on the screen. As shown in 
the section on error trapping, these error messages can be suppressed 
provided you have written an alternative routine for the computer to 
follow using ON ERROR... 


As well as an error message, the computer sets two variables each time 
an error occurs: 


ERR gives the error number. 
ERL gives the line number at which the error was noticed. 


The error messages are listed here in alphabetical order, alongside their 
error numbers: 


Accuracy lost ' 23 


If you try to calculate trigonometric functions with very large angles you 
will lose a lot of accuracy in reducing the angle to within the range of plus 
or minus PI radians. When this happens the computer will print the 
above message, for example: 


PRINT COS(11111111) 


Arguments 31 


This indicates that there are too many or too few arguments for a given 
function or procedure. 


Array 14 


This indicates that the computer expects an array, but cannot find it. 


Bad call 30 
Incorrect PROC or FN call. 


Bad command 254 
Wrongly typed OS command, for example: 
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*FX26,A 


Bad DIM 16 


Arrays and memory must be dimensioned with a positive number of 
elements. For example, these will produce errors: 


DIM array(—19) 
DIM P% —2 
Bad hex 28 


Hex numbers may only consist of $ to 9 and A to F. 


Bad key 251 


Error in *KEY command, including running out of space for key string, 
and attempting to re-define a key while it is in use. 


Bad MODE 25 


You cannot change mode inside a PROC or FN. Nor can you change to a 
mode which would make HIMEM less than LOMEM. 


Bad Program 


There are a number of occasions when the computer checks a program to 
see where it starts and ends in memory. The above error means that the 
computer could not follow the program successfully and that it is 
therefore aborted. This error is untrappable, which means that you 
cannot find out at which line it occurred, nor can you retrieve any part of 
the program! It is caused by part of the program becoming over-written 
either by a mode change or by another program’s BASIC variables. 


Block? 218 


This is an error generated by the cassette filing system. It means that the 
computer found a non-consecutive block number. Re-wind the tape a 
little way and try again. 


Byte 2 


Caused in assembly by trying to load a register in immediate mode witha 
value greater than 255, for example: 
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LDY #266 


Can’t match FOR 33 


The control variable associated with NEXT is different from that 
associated with FOR. 


Channel 222 


This error is generated by the cassette filing system when you try to use a 
file channel number which has not been opened. 


Data? 216 


This is an error generated by the cassette filing system which means that 
the computer has missed some data from a block. Re-wind the tape a 
little and try again. 

DIM space 11 


There is not enough memory for the array to be dimensioned. 


Division by zero 18 


You cannot divide by zero. 


$range 8 


Strings may not be placed in the zero-page of memory using the 
indirection operator $. This is illegal: 


$&76 = “error” 


Eof 223 


This error is given by the cassette filing system if the end of file is 
reached. 


Escape 17 
The | ESCAPE | key has been pressed. 
Exp range 24 


You cannot exponentiate a number greater than 88. The following is 
illegal: 
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A= EXP 99 
Failed at ... (line number) 


Caused by renumbering a program with a GOTO or GOSUB to a non- 
existent line number. 


15 X = 12 
34 GOTO 299 
48 END 


will give the error message: 
Failed at line 29 


File? 219 


This error is generated by the cassette filing system and means that the 
computer was given an unexpected file name. 


FOR variable 34 
The control variable in a FOR . . . NEXT loop must be numeric, for 
example: 


FOR IS = 9 TO 29 
is illegal. 


Header? 217 


This error is generated by the cassette filing system and it means that the 
computer cannot read the file’s header (which contains the name, block 
number etc). Re-wind the tape a little way and try again. 


Index 3 


This error occurs during assembly if you use an incorrect index mode, for 
example: 


LDA (&79,Y} 
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LINE space 


The computer has run out of memory for you to type any extra lines into a 
program. 


Log range 22 
You cannot find the log of a negative or zero number. 
Missing , 5 


This means that the computer expected to find a comma in the line, but 
didn’t do so, for example: 


C$ = LEFTS(Z$) 

Missing ” 9 
This means the computer expected to find a quote, for example: 
CHAIN “MARSLANDER 


Missing )} 27 


This means the computer expected to find a closing bracket, for 
example: 


PRINT TAB(6,16 

Missing # 45 
This means the computer expected to find a hash, for example: 

1% = BGET file 


Mistake 4 


This means that the computer could not understand the instruction, for 
example: 


1p PRIT 
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—ve root 21 


You cannot find the square root of a negative number. This may also 
occur with ASN and ACS. 


No GOSUB 38 
The computer encounters RETURN without having passed a GOSUB. 


No FN 7 


The computer encounters the end of a function definition without having 
passed the DEF FN, for example: 


=X 


No FOR 32 
The computer encounters NEXT without having passed the FOR. 


No PROC 13 


The computer encounters ENDPROC without having passed the DEF 
PROC. 


No REPEAT 43 
The computer encounters UNTIL without having passed the REPEAT. 


No room 9 


When a program is running, the computer uses the area of memory 
between LOMEM and HIMEM to store the BASIC variables. If there is 
insufficient room to store any more of these variables then the above 
error is given. This most commonly occurs with programs which use 
arrays in conjunction with a large screen mode (@, 1, 2, or 3). 


No such FN/PROC 29 
The computer encounters an FN or a PROC for which it can find no 
definition. 

No such line 41 


Electron BASIC does not allaow you to GOTO or GOSUB a line number 
which does not exist. 
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No such variable 26 


All variables must be declared, either globally by assigning them a value 
or locally by using LOCAL. If the computer encounters an un-declared 
variable it gives the above error. This error is also given in assembler 
when the computer encounters a forward reference to a label. 


No TO 36 
TO is omitted from the FOR . . . NEXT loop: 


FOR I=§ 
Not LOCAL 12 


Local variables may be declared only within an FN or a PROC. 


ON range 49 


The control variable for ON GOTO or ON GOSUB is either less than 1 or is 
greater than the number of entries in the list of line numbers. For 
example, the following will not work if destination = 3: 


ON destination GOTO 69,219 


because there are only two destinations. This error may be accounted for 
by using ELSE: 


ON destination GOSUB 79,99 ELSE... 


ON syntax 39 


The word ON must be followed either by ERROR, or by anumeric variable 
and GOTO or GOSUB. The following will give an error: 


ON direction PRINT 


Out of DATA 42 


The computer encounters a READ instruction for which it cannot find an 
entry in the DATA list. RESTORE can be used to move the data-pointer 
back to the start of a DATA list. 
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Out of range 1 


Branch instructions in assembler can access not farther than 127 bytes 
forwards or 128 bytes backwards. To branch outside these limits you 
must use JMP or JSR. 


Silly ) 


Given by the automatic line numbering system AUTO or the line 
renumbering system RENUMBER if you attempt to use a step size of less 
than 1 or more than 255. 


String too long 19 


The maximum length of a string is 255 characters. 


Subscript 15 


An array subscript is out of range, either less than 9 or greater than the 
value declared in DIM. 


Syntax 226 
Bad syntax in the cassette filing system. 


Syntax error 16 


A statement is incorrectly terminated, for example: 
LIST. 59 


Too big 20 


The computer calculates a number which is too big or too small to be 
represented. 


Too many FORs 35 
FOR... NEXT loops may be nested to a depth of 14, and the control vari- 
ables must all be different. 

Too many GOSUBs 37 
GOSUB . . . RETURN loops may be nested to a depth of 26. 
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Too many REPEATs 44 
REPEAT . . . UNTIL loops may be nested to a depth of 29. 


Type mismatch 6 


You cannot assign.a string to a numeric variable or a number to a string 
variable. 
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Operating system calls 


The computer’s operating system is a program, stored in read-only 
memory, which runs continually, sorting out what goes where and when. 
Some parts of the operating system can be accessed from BASIC, and 
these instructions all begin with an asterisk, When executing BASIC, the 
computer will pass these instructions straight to the operating system. 


Here is a list of available commands: 


*CAT 


*SAVE 


*RUN 


*LOAD 


*OPT 


Catalogues all file names on cassette, and displays them 
on the screen. Can be shortened to *. 


Saves a section of memory onto tape. *SAVE “File” 1999 
IP FF 192A will save a page of memory, called File, from 
address &1999 to &1@FF, and an execution address (for 
use by *RUN) of 192A. If the execution address is 
omitted, it is assumed to be equal to the start address. 


Loads and runs a program stored by *SAVE. *RUN “File” 
will load and run the example given in*SAVE above. 


Loads a file and stores it in memory at a specified 
address. *LOAD “Game” 2999 will load from tape a file 
called Game, and store this at location &2899. 


Determines the computer’s reaction to errors during 
cassette operations. 


*OPTIX Controls the error messages given. 

x= Gives no messages. 

X=1 Gives short messages (as normal). 
X=2 Gives long messages, including load and 


execution addresses. 


*OPT2.X Controls the computer’s action, 


X=¢ Lets the computer ignore all errors, and 
carry on regardless. Messages can still be 
given. 

X=1 The computer asks you to try again by re- 


winding the tape (as normal). 
X=2 The computer aborts the operation. 


*SPOOL 


*EXEC 


*MOTOR 


*KEY 
*FX 


*HELP 
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¥*OPT3,X Sets the inter-block gap — the time delay 
between each page of memory stored on 
the tape. X determines the gap in tenths 
of a second. This only applies to PRINT# 
and BPUT#. The gap on SAVE is fixed at 
0.6 seconds. 


*OPT On its own sets all the values to normal. 


Used for saving a program listing or results (as long as 
they are ASCII characters) to cassette or disc as a text 
file. Thus *SPOOL FRED opens a file called FRED on 
either tape or disc. Whatever characters appear on the 
screen after that (eg a program listing called up by LIST, 
or one you enter on the keyboard) will be saved to 
FRED as a text file. To close the file, type *SPOOL 


ating at the end. 


Loads a file from tape, as input rather than as a 
program. Used for loading a file which has been 
¥*SP00Led. 


Used to turn the cassette motor relay on or off. 
*MOTOR®G for off, *MOTOR1 for on. 


Programs a user-defined function key. 


A family of operating system commands which are 
described in Appendix D. 


Gives version numbers of current software. 


Appendix D 
*FX calls 


*EX calls provide a variety of controls for operating system functions 
such as auto-repeat, flash-rate, buffer-flushing, memory allocation etc, 
etc. The following is a description of all *FX calls available from BASIC. 


Call Description 


*EXG Prints a message on the screen telling which operating 
system you have. Operating systems are updated from 
time to time by the manufacturer. 


*EXG Controls the operation of the four ‘arrow’ keys and 
| COPY Fi 


*FX4,1 disables their editing function, and causes them 
to generate ASCII codes, just like any other key: 


135 


‘left-arrow’ key 136 
‘right-arrow’ key 137 
‘down-arrow’ key 138 
‘up-arrow’ key 139 


*FX4,2 allows the five keys to be user-programmable. 
Their key values become: 


COPY *KEY11 


‘left-arrow’ key *KEY12 
‘right-arrow’ key *KEY13 
‘down-arrow’ key *KEY1A 
‘up-arrow’ key *KEY15 


*FX4,9 resets the keys to their normal function of 
editing. It reverses *FX4,1 and *FX4,2. 


*FX9 Used to set the flash-rate of flashing colours. *FX9 
*FX19 controls the duration of the first colour, *FX1$ the 
duration of the second. 


*FX11 


*FX12 


*FX13 
*FX14 


*FX15 
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*FX9,25 
*FX19,25 


Will set each colour to stay on for equal time of 25 
fiftieths (4) of a second. These are in fact the normal 
values when the machine is switched on. 


You could change them to: 


*FX 9,49 
*FX19,29 


which will make the first colour stay on for twice as long 
as the second; for 4/5 and 2/5 of a second respectively. 
If one duration is set to , the other colour will stay on all 
the time. 


Sets the delay, when a key is pressed, before the auto- 
repeat comes into action. 


*FX11,59 will set the delay to 59 hundredths (4) of a 
second, 


¥*FX11,@ turns off the auto-repeat altogether. 
Sets the period of auto-repeat. 


*EX12,19 sets the auto-repeat to 19 hundredths (1/19) 
of a second between characters, giving 19 characters 
per second. 


¥*EX12,9 resets both *FX11 and *FX12 to their normal 
values. As an example, type in the following: 

*FX12,1 RETURN 

*FX11,1 RETURN 


and now try typing in anything at all! 


Disable/enable events. 
See chapter on Assembly Language. 


Flushes (empties) certain buffers (short term mem- 
ories). 
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*FX18 
*FX19 


*FX29 


*FX15,8 flushes all buffers. 
*FX15,1 flushes the currently selected input buffer. 


Resets all the user-programmable keys to empty. 


Makes the computer wait for the start of the next screen 
display frame. 


Determines the amount of memory which can be set 
aside for character definitions. 


*FX29,9 implodes the character definitions. This means 
that the extra memory set aside for extra character 
definitions by *FX29,1 to*FX2G,6 is returned to the user 
for storing BASIC programs. 


¥*FX29.1 to *FX2Q,6 explodes the memory to store 
groups of 32 extra character definitions. All characters 
with ASCII codes 32 to 255 may be user defined. As 
described in chapter 21, ASCII codes 128 to 255 may be 
defined without using a *FX2§ command, but only 32 
consecutive characters can be defined. *FX2§,1 to 
*FX29,6 take chunks of memory from the BASIC 
program storage area to hold specific definitions, and 
this is shown in the table below. 


ASCII code *FX Memory allocation 

128-159 *FX200 &COG to &CFF 

16@-191 *FX29,1 OSHWM to OSHWM + &FF 

192-223 *FX29,2 OSHWM + &19¢ to OSHWM+ &1FF 

224-255 *FX29,3 OSHWM + &26¢ to OSHWM+ &2FF 
32- 63 *FX29,.4 OSHWM + &399 to OSHWM + &3FF 
64- 95 *FX29,5 OSHWM + &4@9 to OSHWM+ &4FF 
96-127 *FX20,6 OSHWM + &599 to OSHWM+ &5FF 


OSHWM stands for Operating System High Water 
Mark, and means the point where the memory (from 
&0@) occupied by the operating system ends, and the 
memory occupied by BASIC programs begins. Turn to 
chapter 23 for the computer's memory map. The 
OSHWM normally sits at &E 69, but this will change 
when a software expansion has been fitted, eg a disc 
filing system. 


If you explode the memory allocation in this way you 
must remember to reset PAGE higher up the memory. A 
program stored at &EG@ may be lost. 


*FX21 


*FX124 


*FX125 


*FX126 


*FX138 


*FX225 


*FX226 
*FX227 


Appendix D 283 


Flushes (empties) certain buffers (short term mem- 
ories). 

*FX21,8 flushes the keyboard buffer. 

*EX21,4 flushes sound channel 9. 

*FX21,5 flushes sound channel 1. 

*EX21,6 flushes sound channel 2. 

*FX21,7 flushes sound channel 3. 


Used to reset the flag at memory location &#GFF which 
tells when an ESCAPE has occurred. 


Sets the above-mentioned flag. Has similar effect to 
pressing the | ESCAPE | key. 


Used when reading characters from an input stream 
using OSRDCH.*FX126 acknowledges the detection of 
an ESCAPE. 


Used to insert a character into the keyboard buffer. 
*FX138,9,X will insert CHRS X. 
Disables all the user-definable keys. 


Disables GID A to HDG p. 
Disables | FUNC] Q onwards. 


With a parameter value other than the two given above, 
*FX225-227 will cause [1g keys to give ASCII codes. 
For example, *FX226,224 will cause [IDI A to give 
224, B to give 225, etc. At this setting (*FX226, 
224), [ FUNC | A onwards will give the standard range of 
user-defined characters direct from the keyboard. Any 
number from 2 to 255 may be used as the parameter for 
*FX226, and determines the base code, which will be 
given by [DT a. 


Appendix E 
Fast and efficient 
programs 


Programming 


The book which accompanies this one, called Start Programming with the 
Electron, is intended as a guide to writing programs in Electron BASIC. 
Once you start writing your own programs, however small they may be, 
please make good use of the Start Programming with the Electron book. It 
will help you to develop a good style and help you to avoid getting into 
bad habits. You will find the programs referred to in the book on the 
Introductory Cassette. 


Speeding up programs 


There may be times where the program must run as quickly as possible, 
and here are a few tips for increasing execution speed. 


~— Use integer variables rather than real variables wherever possible. 

- Use integer division (DIV) rather than normal division (/). 

— Use integer arrays rather than real arrays. 

— Start your variable names with different letters of the alphabet. 

— Omit the control variable after the instruction NEXT. 

~ REPEAT... UNTIL loops are faster than IF... THEN GOTO loops. 

— Use procedures instead of GOSUBs. 

— Use as few line numbers as possible by using a colon to separate each 
statement. 

— Leave out as many spaces as possible, without confusing the com- 
puter. 

- Omit REM statements. 


Some of these tips will have the effect of making your programs less 
readable. This is not a good thing, but in cases where speed is all 
important, you may find that you will have to reach a compromise between 
readability and execution speed. 
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ASCII displayed 
character set and 


control codes 


Nothing 


Default 
logical 
colours 


Sy 


Move text 
cursor 
10 00 


es es ws ow 


Next to 
printer 


Start 
printer 


Separate 
cursors 


Disable 
VDU 


Move 
text 
cursor 


Select 
mode 


Start of Reprogram 
line characters 


Paged Nothing 


mode 


Join 
cursors 


— 


Seroll 
mode 


Clear Default 
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Each displayed character consists of 8 rows of 8 dots 
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User defined planning sheet 
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Text planning sheet 
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Graphics planning sheet 1 (grid related to character positions) 
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Graphies planning sheet 2 (decimal) 
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Electron User Guide Errata 


Key Z rotates the craft anticlockwise, not key Y. 
Listing at bottom of page: line 20 should read 
20 PRINT A$;A$;AS 
Line 30 of the listing should read 
30 PRINT X,X,X'A4,A$,A$ 
2(ii): @% = &0090A 
Last sentence should read — If you don’t press a key in time, | N K E Y S will give a null string 
(ASCII value —1). 
First sentence should read — Programs and parts of programs can be made to execute over and 
over again, either continuously, a specified number of times or until a certain event happens. 
Third line from top should read 
40 UNTIL FALSE 
Second sentence of text should read — You will see that only real numbers 
-1<X<1 are treated as FALSE, all other values being TRUE. 
Line 40o0f the second listing (12 lines down) should read 
40 UNTIL O 
Beginning of last paragraph on page should read —This will be false, because... 
Line 10 of the listing should read 
10 PRINT ‘SCREENFUL’; 
ELSE may be used with ON. .GOTO and ON.. .GOSUB to trap any value which 
is out of range. For example 
ON N GOSUB 100,200,70,260 ELSE 999 
will GO SUB 999 for any value of N outside the range ito 4. 
First line of second paragraph should read — Each pixel has a logical colour... Fifth sentence in 
this paragraph should read —EOR means ‘exclusive OR’, which is a non-equivalence 
comparison giving a 1 result when the compared bits are different (1 and 0, or 0 and 1), anda 0 
result when the compared bits are the same (0 and 0, or land 1). 


p100 Ignore references to-F X 13. 
p101 Four lines from top of page should read 
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VDU24,a; b; c; d; 

where a ,b and c ,d are the coordinates of the 

2 lines from top of page should read 

*SAVE filename” SSSS FFFF EEEE RRRR RETURN 


Insert the following underneath the above —RRRR is the hex address at which the program 
will reload. 

KEY 3 definition should read 

*KEY3 ‘10 REPEAT |M 20 PRINT CHR$(RND(95)+31); [M 30 UNTIL VPOS=24 |M RUN |M 
OPEN U P: insert following note—Note that for the cassette filing system, this command _ is 
equivalent to OPEN | N (ie input only). 
See above note. 
Middle of page, end of paragraph should read —.. contents of memory location 

&BBAA. 
Swap text in boxes 24 and 27. 

Character number 127 should have the following description — backspace and delete. 


